本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將 Athena 目錄匯入至 AWS Glue
<a name="aws-glue-api-catalog-migration"></a>

遷移 API 說明與遷移 Athena 資料目錄相關的 AWS Glue 資料類型和操作 AWS Glue。

## 資料類型
<a name="aws-glue-api-catalog-migration-objects"></a>
+ [CatalogImportStatus 結構](#aws-glue-api-catalog-migration-CatalogImportStatus)

## CatalogImportStatus 結構
<a name="aws-glue-api-catalog-migration-CatalogImportStatus"></a>

結構包含移轉狀態資訊。

**欄位**
+ `ImportCompleted` – 布林值。

  如果移轉完成為 `True`，否則為 `False`。
+ `ImportTime` – 時間戳記。

  移轉開始進行的時間。
+ `ImportedBy` – UTF-8 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  啟動移轉的人員名稱。

## 作業
<a name="aws-glue-api-catalog-migration-actions"></a>
+ [ImportCatalogToGlue 動作 (Python: import\_catalog\_to\_glue)](#aws-glue-api-catalog-migration-ImportCatalogToGlue)
+ [GetCatalogImportStatus 動作 (Python: get\_catalog\_import\_status)](#aws-glue-api-catalog-migration-GetCatalogImportStatus)

## ImportCatalogToGlue 動作 (Python: import\_catalog\_to\_glue)
<a name="aws-glue-api-catalog-migration-ImportCatalogToGlue"></a>

將現有的 Amazon Athena Data Catalog 匯入至 AWS Glue。

**請求**
+ `CatalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  欲匯入的目錄的 ID。目前，這應該是 AWS 帳戶 ID。

**回應**
+ *無回應參數。*

**錯誤**
+ `InternalServiceException`
+ `OperationTimeoutException`

## GetCatalogImportStatus 動作 (Python: get\_catalog\_import\_status)
<a name="aws-glue-api-catalog-migration-GetCatalogImportStatus"></a>

擷取移轉操作的狀態。

**請求**
+ `CatalogId` – 目錄 ID 字串，長度不可小於 1 個位元組，也不可以超過 255 個位元組，需符合[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine)。

  欲移轉的目錄的 ID。目前，這應該是 AWS 帳戶 ID。

**回應**
+ `ImportStatus` – [CatalogImportStatus](#aws-glue-api-catalog-migration-CatalogImportStatus) 物件。

  指定的目錄移轉的狀態。

**錯誤**
+ `InternalServiceException`
+ `OperationTimeoutException`