在的工作 AWS Data Exchange - AWS Data Exchange 使用者指南

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

在的工作 AWS Data Exchange

AWS Data Exchange 工作是非同步匯入或匯出作業。

身為提供者,您可以建立和管理要發佈至產品的資料集。您可以將資產或修訂下載 (匯出) 或複製到 Amazon Simple Storage Service (Amazon S3) 或已簽署URL。此外,供應商可以從 Amazon API 閘道匯入資產,API或從 Amazon Redshift 資料集匯入資產。

身為訂閱者,您可以透過訂閱檢視和存取您擁有權利的資料集。您可以使用API操作將授權的資料集下載 (匯出) 或複製到 Amazon S3,以搭配各種 AWS 分析和機器學習服務使用。

若要透過工作建立或複製資產或複製修訂,您可以使用 AWS Management Console、 AWS Command Line Interface (AWS CLI)、您自己的REST應用程式或其中一個 AWS SDKs。

工作會在建立 90 天後刪除。

任務屬性

工作具有下列屬性:

  • Job ID — 建立作業時產生的 ID,可唯一識別工作。

  • Job 類型 — 支援下列工作類型:

    • 從 Amazon S3 匯入

    • 匯入資 AWS Lake Formation 料權限 (預覽)

    • 從簽署匯入 URL

    • 從 Amazon API 網關導入 API

    • 從 Amazon Redshift 的 AWS Data Exchange 數據清單導入

    • 匯入 Amazon S3 資料存取

    • 匯出至 Amazon S3

    • 匯出至已簽署 URL

  • Amazon 資源名稱 (ARN) — 資 AWS 源的唯一識別碼。

  • Job 狀態 — 工作狀態為WAITINGIN_PROGRESSCOMPLETEDCANCELLEDERROR、或TIMED_OUT。建立工作時,工作會一直處於狀WAITING態,直到工作開始為止。

  • Job 詳細資訊 — 工作要執行的作業詳細資訊,例如匯出目的地詳細資訊或匯入來源詳細資訊。

範例 工作資源
{ "Arn": "arn:aws:dataexchange:us-east-1:123456789012:jobs/6cEXAMPLE818f7c7a23b3d0EXAMPLE1c", "Id": "6cEXAMPLE818f7c7a23b3d0EXAMPLE1c", "State": "COMPLETED", "Type": "IMPORT_ASSETS_FROM_S3", "CreatedAt": "2019-10-11T14:12:24.640Z", "UpdatedAt": "2019-10-11T14:13:00.804Z", "Details": { "ImportAssetsFromS3": { "AssetSources": [ { "Bucket": "amzn-s3-demo-bucket", "Key": "MyKey" } ], "DataSetId": "14EXAMPLE4460dc9b005a0dEXAMPLE2f", "RevisionId": "e5EXAMPLE224f879066f999EXAMPLE42" } } }

AWS 區域 和工作

如果您將資產匯入或匯出到與資料集區域不同的 Amazon S3 儲存貯體,則會根據 Amazon S3 資料傳輸定價政策向您 AWS 帳戶 收取資料傳輸費用。 AWS 區域

如果您將資產匯出到已簽署的資產URL, AWS 帳戶 則會根據 Amazon S3 定價政策向您收取從 Amazon S3 到網際網路的資料傳輸費用。

當您 AWS Data Exchange 對 Files 資料集的訂閱結束時,您會保留對已匯出之任何檔案的存取權。檢閱您的資料訂閱合約,以確認您的合約是否要求您在結束訂閱時刪除匯出的資料。

匯入資產

您可以使用下列方式將資產匯入修訂版本:

從 S3 儲存貯體匯入資產

將資產從 Amazon S3 匯入到時 AWS Data Exchange,您使用的 AWS Identity and Access Management (IAM) 許可必須包含寫入 AWS Data Exchange 服務 S3 儲存貯體以及從存放資產的 S3 儲存貯體讀取資產的能力。無論擁有權為何,您都可以從任何有權存取的 S3 儲存貯體匯入。如需詳細資訊,請參閱Amazon S3 許可

您可以在單一工作中匯入多達 100 個資產。

從 S3 儲存貯體匯入資產 (AWS SDKs)

若要從 Amazon S3 儲存貯體匯入資產 (AWS SDKs)
  1. 建立類型的CreateJob請求IMPORT_ASSETS_FROM_S3

  2. 請求中包含以下內容:

    • AssetSources

      • Bucket

      • Key

    • DataSetID

    • RevisionID

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. (選擇性) 建立資產之後,請更新資產的名稱屬性。

從 S3 儲存貯體 (主控台) 匯入資產

從 S3 儲存貯體 (主控台) 匯入資產
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要更新修訂的資料集。

  4. 在 [修訂] 索引標簽上,選擇 [建立修訂] 以開啟 [建立修訂] 頁面。

    1. 對於 「版序」設定,請為修訂提供描述修訂用途的可選註解。

    2. 對於添加標籤-可選,添加與資源關聯的標籤。

    3. 選擇 Create (建立)。

      您的新修訂版本隨即建立。

  5. 在「任務」區段中,選擇「從 Amazon S3 匯入」。

  6. 按照從 Amazon S3 匯入視窗中的提示進行操作,然後選擇「匯入資產」。

    工作已開始將您的資產匯入資料集。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

從已簽署的資產匯入 URL

您可以使用已簽署URLs來匯入未存放在 Amazon S3 中的資產。

從已簽署的 URL (AWS SDKs) 匯入資產

若要從已簽署的 URL (AWS SDKs) 匯入資產
  1. 建立類型的CreateJob請求IMPORT_ASSET_FROM_SIGNED_URL

  2. 請求中包含以下內容:

    • AssetName

    • DataSetID

    • Md5Hash

    • RevisionID

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. (選擇性) 建立資產之後,請更新資產的名稱屬性。

  5. 響應詳細信息包括您SignedUrl可以用來導入文件的詳細信息。

注意

簽署的項目會在建立後一分鐘URL過期。

從已簽署 URL (主控台) 匯入資產

從已簽署 URL (主控台) 匯入資產
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要更新之資產的資料集。

  4. 在 [修訂] 索引標簽上,選擇 [建立修訂] 以開啟 [建立修訂] 頁面。

    1. 對於 「版序」設定,請為修訂提供描述修訂用途的可選註解。

    2. 對於添加標籤-可選,添加與資源關聯的標籤。

    3. 選擇 Create (建立)。

      您的新修訂版本隨即建立。

  5. 在「工作」段落中,選擇上傳

  6. 依照上傳視窗中的提示進行操作,然後選擇「開啟」。

    工作已開始將您的資產匯入資料集。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

從 Amazon API 網關導入資產 API

AWS Data Exchange 訂閱者可以使用其IAM憑據並 AWS SDKsAPIs從數據提供者撥打電話。 AWS Data Exchange APIs透過處理驗證和訂閱權利來管理對的存取。

從 Amazon API 網關導入API資產 API (AWS SDKs)

注意

目前,下列情況不支援此SendApiAsset作業SDKs:

  • AWS SDK for .NET

  • AWS SDK for C++

  • AWS SDK for Java 2.x

若要從 Amazon API 閘道匯入資產 API (AWS SDKs)
  1. 建立類型的CreateJob請求IMPORT_ASSET_FROM_API_GATEWAY_API

  2. 請求中包含以下內容:

    • ApiID

    • DataSetID

    • ProtocolType

    • RevisionID

    • Stage

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. (選擇性) 輪詢GetJob作業以等待工作完成。

  5. (選擇性) 建立資產之後,請更新資產的名稱屬性。

從 Amazon API 閘道 API (主控台) 匯入API資產

若要從 Amazon API 閘道 API (主控台) 匯入資產
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要更新之資產的資料集。

  4. 在 [修訂] 索引標簽上,選擇 [建立修訂] 以開啟 [建立修訂] 頁面。

    1. 對於 「版序」設定,請為修訂提供描述修訂用途的可選註解。

    2. 對於添加標籤-可選,添加與資源關聯的標籤。

    3. 選擇 Create (建立)。

      您的新修訂版本隨即建立。

  5. 在「API資源」區段中,選擇「新增API階段」。

  6. 新增API階段頁面上,從您 AWS 帳戶 或其他帳戶選取 Amazon API 閘道API階段名稱

  7. 對於訂閱者API的文件

    1. API名稱更新為訂閱者可以理解的清晰簡潔名稱。

    2. 在欄位中輸入規格以記錄 Open API 3.0 規格,並選擇匯入來源來匯入規格。 JSON檔案,或選擇從 Amazon API 閘道匯入來匯入規格。

  8. 選擇「新增API階段」。

    工作已開始將您的API資產匯入資料集。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

從 Amazon Redshift 的數 AWS Data Exchange 據清單導入資產

當您使用適用於 Amazon Redshift 的資 AWS Data Exchange 料清單匯入資產時,您可以在訂閱後開始查詢、分析和操作第三方 Amazon Redshift 表格。

從 Amazon Redshift()的 AWS Data Exchange 數據清單導入資產AWS SDKs

若要從 Amazon Redshift 的資 AWS Data Exchange 料清單匯入資產 ()AWS SDKs
  1. 建立類型的CreateJob請求IMPORT_ASSETS_FROM_REDSHIFT_DATA_SHARES

  2. 請求中包含以下內容:

    • AssetSources

      • DataShareArn

    • DataSetID

    • RevisionID

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. (選擇性) 輪詢GetJob作業以等待工作完成。

  5. (選擇性) 建立資產之後,請更新資產的名稱屬性。

從 Amazon Redshift(控制台) AWS Data Exchange 的數據清單導入資產

若要從資ADE料清單匯入資產 (適用於 Amazon Redshift 主控台)
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要更新之資產的資料集。

  4. 在 [修訂] 索引標簽上,選擇 [建立修訂] 以開啟 [建立修訂] 頁面。

    1. 對於 「版序」設定,請為修訂提供描述修訂用途的可選註解。

    2. 對於添加標籤-可選,添加與資源關聯的標籤。

    3. 選擇 Create (建立)。

      您的新修訂版本隨即建立。

  5. 對於 Amazon Redshift 的AWS Data Exchange 數據庫部分,選擇添加數據庫。

  6. 在 [新增 AWS Data Exchange 資料清單至修訂] 頁面上,選取您要新增的資料清單或資料存。

  7. 選擇新增資料識別

    工作已開始將您的資產匯入資料集。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

從匯入資產 AWS Lake Formation (預覽)

當您將資產從匯入 AWS Lake Formation 到時 AWS Data Exchange,您使用的IAM權限必須包含下列功能:

  • 寫入、授予和撤銷 Lake Formation 權限

  • 為表格、資料庫和目錄建立資源共用

  • 更新、刪除、關聯和取消關聯從 Lake Formation 開始的任何資源共用的資源共用

如需必要和建議IAM權限的詳細資訊,請參閱身分識別與存取管理 AWS Data Exchange

從 AWS Lake Formation (預覽) (AWSSDKs) 匯入資產

若要從 AWS Lake Formation (預覽) 匯入資產 (AWSSDKs)
  1. 建立類型的CreateJob請求Import_Assets_From_Lake_Formation_Tag_Policy

  2. 請求中包含以下內容:

    • AssetSources

      • CatalogId

      • Database

        • Expression

          • TagKey

          • TagValues

        • Permissions

      • Table

        • Expression

          • TagKey

          • TagValues

        • Permissions

    • RoleArn

    • DataSetId

    • RevisionId

  3. 使用需CreateJob要的作StartJob業啟動要求JobId

  4. (選擇性) 輪詢GetJob作業以等待工作完成。

  5. (選擇性) 建立資產之後,請更新資產的名稱屬性。

從 AWS Lake Formation (預覽) (主控台) 匯入資產

從 AWS Lake Formation (預覽) (主控台) 匯入資產
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要更新修訂的資料集。

  4. 在 [修訂] 索引標簽上,選擇 [建立修訂] 以開啟 [建立修訂] 頁面。

    1. 對於 「版序」設定,請為修訂提供描述修訂用途的可選註解。

    2. 對於添加標籤-可選,添加與資源關聯的標籤。

    3. 選擇 Create (建立)。

      您的新修訂版本隨即建立。

  5. 對於 L ake Formation 數據權限部分,選擇添加 LF 標籤。

  6. 選擇您要新增的「機」和「」,然後選擇「新增 LF 標籤」。

    1. (選擇性) 選擇預覽資源以檢視您授與權限的關聯資料目錄資源。

  7. 服務存取中,選取要匯入 AWS Lake Formation 資源的角色 AWS Data Exchange。

  8. 選擇「建立 Lake Formation 資料」權限

    工作已開始將您的資產匯入資料集。工作完成後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

匯出資產

供應商和訂閱者都可以從產品的已發佈版本匯出資產。匯出資產的方式有兩種:

將資產匯出到 S3 儲存貯體

將資產匯出到 Amazon S3 時,您使用的IAM許可必須包含從 AWS Data Exchange 服務 S3 儲存貯體讀取以及寫入資產存放所在 S3 儲存貯體的能力。無論擁有權為何,您都可以匯出到您有權存取的任何 S3 儲存貯體。如需詳細資訊,請參閱Amazon S3 許可

AWS Data Exchange 將資料集匯出到 Amazon S3 時,支援可設定的加密參數。在匯出任務詳細資訊中,您可以指定要套用至匯出物件的 Amazon S3 伺服器端加密組態。您可以選擇將伺服器端加密與 Amazon S3 受管金鑰 (SSE-S3) 搭配使用,或使用 AWS KMS keys 存放於 AWS Key Management Service (SSE-) 的伺服器端加密。KMS如需詳細資訊,請參閱《Amazon Simple Storage Service 使用者指南》中的使用伺服器端加密保護資料

重要

我們建議您在將資料匯出到 Amazon S3 時考慮使用 Amazon S3 安全功能。如需有關一般指導方針和最佳實務的資訊,請參閱 Amazon 簡單儲存服務使用者指南中的 Amazon S3 安全最佳實

重要

如果供應商已將某項產品標示為包含受保護的 Health 資訊 (PHI),受到 1996 年《健康保險流通與責任法案》(HIPAA) 規範 (),您不得將該產品的資料集匯出至您的, AWS 帳戶 除非該資料集 AWS 帳戶 被指定為HIPAA帳戶 (如中的《 AWS 商業夥伴附錄》中AWS Artifact所定義)。

單一工作最多可以匯出 100 個資產。

下列影片說明如何從中轉存資產的詳細資訊 AWS Data Exchange。

將資產匯出到 S3 儲存貯體 (AWS SDKs)

將資產匯出到 S3 儲存貯體 (AWS SDKs)
  1. 建立類型的CreateJob請求EXPORT_ASSETS_TO_S3

  2. 請求中包含以下內容:

    • AssetDestinations

      • AssetID

      • Bucket

      • Key

    • DataSetID

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionID

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. (選擇性) 建立資產之後,請更新資產的名稱屬性。

注意

若要取得有關將整個修訂匯出為單一工作的資訊,請參閱〈〉匯出修訂

以訂閱者 (主控台) 的身分將資產匯出至 S3 儲存貯體

以訂閱者 (主控台) 的身分將資產匯出至 S3 儲存貯體
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,針對 [我的訂閱] 選擇 [授權資料]。

  3. 授權資料中,選擇具有您要匯出之修訂版本的產品。

  4. 獲權資料集中,選擇資料集。

  5. 請在「版本」標簽中選擇版本。

  6. 在「資產」標籤中,選取您要轉存之資產旁邊的核取方塊。

  7. 選取匯出動作,然後選擇將選取的資產匯出到 Amazon S3

  8. 按照「匯出到 Amazon S3」視窗中的提示進行操作,然後選擇「匯出」。

    工作已開始匯出您的資產。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

將資產匯出到 S3 儲存貯體做為提供者 (主控台)

以供應商 (主控台) 的身分將資產匯出到 S3 儲存貯體
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要匯出之資產的資料集。

  4. 導覽至「產」標籤,以確定資料集與已發佈的產品相關聯。

  5. 從「序」頁籤中選取版序。

  6. 在「匯入的資產」區段中,選取資產名稱旁邊的核取方塊。

  7. 選取匯出動作,然後選擇將選取的資產匯出到 Amazon S3

  8. 按照「匯出到 Amazon S3」視窗中的提示進行操作,然後選擇「匯出」。

    工作已開始匯出您的資產。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

將資產匯出至已簽署 URL

您可以使用已簽署URLs來匯出未存放在 Amazon S3 中的資產。

將資產匯出至已簽署的 URL (AWS SDKs)

您可以使用已簽署URLs將資產匯出到 S3 儲存貯體以外的目的地。

將資產匯出至已簽署的 URL (AWS SDKs)
  1. 建立類型的CreateJob請求EXPORT_ASSET_TO_SIGNED_URL

  2. 請求中包含以下內容:

    • AssetID

    • DataSetID

    • RevisionID

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. (選擇性) 建立資產之後,請更新資產的名稱屬性。

  5. 響應詳細信息包括您SignedUrl可以用來導入文件的詳細信息。

注意

簽署的項目會在建立後一分鐘URL過期。

將資產匯出至以訂閱者URL身分簽署的資產 (主控台)

將資產匯出至以訂閱者URL身分簽署的資產 (主控台)
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,針對 [我的訂閱] 選擇 [授權資料]。

  3. 授權資料中,選擇具有您要匯出之修訂版本的產品。

  4. 獲權資料集中,選擇資料集。

  5. 請在「版本」標簽中選擇版本。

  6. 在「資產」標籤中,選取您要轉存之資產旁邊的核取方塊。

  7. 選取 [匯出動作],然後選擇 [下載選取的資產

    工作已開始匯出您的資產。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

將資產匯出至以提供者URL身分簽署的資產 (主控台)

將資產匯出至以提供者URL身分簽署的資產 (主控台)
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要匯出之修訂版本的產品。

  4. 導覽至「產」標籤,以確定資料集與已發佈的產品相關聯。

  5. 請在「版本」標簽中選擇版本。

  6. 在「匯入的資產」區段中,選取資產名稱旁邊的核取方塊。

  7. 選取 [匯出動作],然後選擇 [下載選取的資產

    工作已開始匯出您的資產。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

匯出修訂

提供者和訂閱者都可以將資料集的修訂匯出到他們有權存取的 S3 儲存貯體。

AWS Data Exchange 將修訂匯出到 Amazon S3 時,支援可設定的加密參數。在匯出任務詳細資訊中,您可以指定要套用至匯出物件的 Amazon S3 伺服器端加密組態。您可以選擇搭配 Amazon S3 受管金鑰 (SSE-S3) 使用伺服器端加密,也可以選擇使用存放在 (-) 中 AWS Key Management Service 的KMS金鑰的伺服器端加密。SSE KMS如需詳細資訊,請參閱 Amazon 簡單儲存服務開發人員指南中的使用伺服器端加密保護資料

重要

如果供應商已將某項產品標示為包含受保護的 Health 資訊 (PHI),受到 1996 年《健康保險流通與責任法案》(HIPAA) 規範 (),您不得將該產品的資料集匯出至您的, AWS 帳戶 除非該資料集 AWS 帳戶 被指定為HIPAA帳戶 (如中的《 AWS 商業夥伴附錄》中AWS Artifact所定義)。

下列影片說明如何從匯出資產 AWS Data Exchange (從 2:18 開始) 的詳細說明。

將修訂匯出至 S3 儲存貯體 (AWS SDKs)

將修訂版匯出到 S3 儲存貯體 (AWS SDKs)
  1. 建立類型的CreateJob請求EXPORT_REVISIONS_TO_S3

  2. 請求中包含以下內容:

    • DataSetId

    • Encryption

      • KmsKeyArn

      • Type

    • RevisionDestinations

      • Bucket

      • KeyPattern

      • RevisionId

  3. 使用需要在步驟 1 中JobId傳回的StartJob作業來啟動要CreateJob求。

  4. 新建立的資產具有等於原始 S3 物件金鑰的 name 屬性。Amazon S3 物件金鑰預設為金鑰模式${Asset.Name}

    您可以在建立資產之後更新資產的 name 屬性。

    如需關鍵模式的詳細資訊,請參閱匯出修訂時的關鍵模式

注意

如果您使用DataSet.Name作為動態參照,則必須具有IAM權限dataexchange:GetDataSet。如需詳細資訊,請參閱AWS Data Exchange API權限:動作和資源參考

將修訂作為提供者 (主控台) 匯出至 S3 儲存貯體

將修訂作為提供者 (主控台) 匯出到 S3 儲存貯體
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,對於 [發佈資料],選擇 [擁有的資料集]。

  3. 擁有的資料集中,選擇具有您要匯出之修訂版本的產品。

  4. 導覽至「產」標籤,以確定資料集與已發佈的產品相關聯。

  5. 請在「版本」標簽中選擇版本。

  6. 在「匯入的資產」區段中,選取資產名稱旁邊的核取方塊。

  7. 選取匯出動作,然後選擇將選取的資產匯出到 Amazon S3

  8. 按照「匯出到 Amazon S3」視窗中的提示進行操作,然後選擇「匯出」。

    工作已開始匯出您的資產。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

以訂閱者 (主控台) 的身分將修訂匯出至 S3 儲存貯體

將修訂版以訂閱者 (主控台) 的身分匯出至 S3 儲存貯體
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,針對 [我的訂閱] 選擇 [授權資料]。

  3. 授權資料中,選擇具有您要匯出之修訂版本的產品。

  4. 獲權資料集中,選擇資料集。

  5. 在 [修訂] 索引標籤上,選取修訂,然後選擇 [匯出到 Amazon S3]。

  6. 將修訂匯出到 Amazon S3 中,選取目的地選項 Amazon S3 儲存貯體資料夾目的地,設定加密選項,然後選擇匯出

    隨即開始匯出修訂的工作。搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

以訂閱者身分自動將修訂匯出至 S3 儲存貯體

當供應商發佈新的修訂版本時,您可以選擇自動將新修訂匯出到 Amazon S3 儲存貯體。您最多可以將新修訂匯出到五個 S3 儲存貯體。新的修訂將自動顯示在您選取的 S3 儲存貯體中。

注意

若要將修訂版本自動匯出到您選擇的 S3 儲存貯體,您的 S3 儲存貯體必須具有設定權限的儲存貯體政策,以允許將資料匯出 AWS Data Exchange 到其中。如需詳細資訊,請參閱S3 儲存貯體政策許可的先決條

S3 儲存貯體政策許可的先決條

在自動將修訂版本匯出到 S3 儲存貯體之前,您必須停用請求者付費,並且 S3 儲存貯體必須具有設定許可的儲存貯體政策,以允許將資料匯出 AWS Data Exchange 到其中。下列程序提供如何編輯現有 S3 儲存貯體政策或使用這些許可建立 S3 儲存貯體政策的相關資訊。

如果您的 S3 儲存貯體設定為 SSE-KMS 加密,則設定自動匯出任務的使用者必須擁有KMS金鑰的CreateGrant權限,才能將物件複製 AWS Data Exchange 到 S3 儲存貯體。

重要

為了確認符合 S3 儲存貯體政策許可的先決條件,在自動匯出程序期間,會將具_ADX-TEST-ACCOUNTID#有命名格式的物件新增至 S3 儲存貯體。

編輯現有的 S3 儲存貯體政策

如果您的 S3 儲存貯體有儲存貯體政策,請完成以下程序以允許 AWS Data Exchange 將資料匯出到該儲存貯體。

編輯現有的 S3 儲存貯體政策
  1. 切換作業選項至您要匯出版次的時段。

  2. 選取 [權限] 索引標籤,然後在值區政策區段中選擇 [編輯]。

  3. 複製下列陳述式,並將其貼到陳述式清單的結尾。

    { "Effect": "Allow", "Principal": { "Service": "dataexchange.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::<BUCKET-NAME>/*", "Condition": { "StringEquals": { "aws:SourceAccount": "<AWS ID>" } } }
  4. <BUCKET-NAME>以 S3 儲存貯體的名稱取代,並<AWS ID>以您的 AWS ID 取代。

  5. 選擇 Save changes (儲存變更)。

  6. 如果您想要新增更多值區做為自動匯出工作的目的地,請從步驟 1 開始重複此程序。

建立 S3 儲存貯體政策

如果您的 S3 儲存貯體沒有儲存貯體政策,請完成以下程序以建立 S3 儲存貯體政策以允許將資料匯出 AWS Data Exchange 到該儲存貯體。

若要建立 S3 儲存貯體政策
  1. 切換作業選項至您要匯出版次的時段。

  2. 選取 [權限] 索引標籤,然後在值區政策區段中選擇 [編輯]。

  3. 複製下列完整值區政策,並將其貼到值區政策編輯器中。

    { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "dataexchange.amazonaws.com" }, "Action": [ "s3:PutObject", "s3:PutObjectAcl" ], "Resource": "arn:aws:s3:::<BUCKET-NAME>/*", "Condition": { "StringEquals": { "aws:SourceAccount": "<AWS ID>" } } } ] }
  4. <BUCKET-NAME>以 S3 儲存貯體的名稱取代,並<AWS ID>以您的 AWS ID 取代。

  5. 選擇 Save changes (儲存變更)。

  6. 如果您想要新增更多值區做為自動匯出工作的目的地,請從步驟 1 開始重複此程序。

以訂閱者 (主控台) 的身分自動將修訂匯出至 S3 儲存貯體

注意

若要將修訂版本自動匯出到您選擇的 S3 儲存貯體,您的 S3 儲存貯體必須具有設定權限的儲存貯體政策,以允許將資料匯出 AWS Data Exchange 到其中。如需詳細資訊,請參閱S3 儲存貯體政策許可的先決條

以訂閱者 (主控台) 的身分自動將修訂匯出到 S3 儲存貯體
  1. 開啟網頁瀏覽器並登入主AWS Data Exchange 控台

  2. 在左側導覽窗格中,針對 [我的訂閱] 選擇 [授權資料]。

  3. 授權資料中,選擇具有您要匯出之修訂版本的產品。

  4. 獲權資料集中,選擇資料集。

  5. 在 [修訂] 標籤的 [自動匯出工作目的地] 下,選擇 [動],然後選擇 [新增自動匯出工作目的地]

  6. 在 [新增自動匯出工作目的地] 中,選擇 [簡單] 或 [進階] 目的地選項。

    1. 如果您選擇「簡單」選項,請從下拉式清單和加密選項中選取 Amazon S3 儲存貯體資料夾目的地,然後選擇「新增儲存貯體目的地」。

    2. 如果您選擇進階選項,請從下拉式清單中選取 Amazon S3 儲存貯體資料夾目的地,選取金鑰命名模式並將其附加至路徑。

  7. 檢閱輸出

  8. 設定加密選項、檢閱 Amazon S3 定價,然後選擇新增儲存貯體目的地

    Amazon S3 儲存貯體目的地會顯示在「自動匯出任務目的地」下的「修訂」標籤上

    隨即開始工作以自動匯出修訂版本。

    若要確認符合 S3 儲存貯體政策許可的先決條件,會將具有命名格式_ADX-TEST-ACCOUNTID#的物件新增至 S3 儲存貯體。

    搜尋工作後,[工作] 區段中的 [狀態] 欄位會更新為 [已完成]。

    若要新增其他目的地,請選擇 [作],然後選擇 [新增自動匯出工作目標

    若要編輯,請選取您要編輯的目的地,選擇動作,然後選擇編輯目的地組態

    若要刪除,請選擇 [動],然後選擇 [移除自動匯出工作目的地]。

以訂閱者身分自動將修訂匯出至 S3 儲存貯體 (AWS SDKs)

注意

若要將修訂版本自動匯出到您選擇的 S3 儲存貯體,您的 S3 儲存貯體必須具有設定權限的儲存貯體政策,以允許將資料匯出 AWS Data Exchange 到其中。如需詳細資訊,請參閱S3 儲存貯體政策許可的先決條

自動將修訂匯出到 S3 儲存貯體 (AWS SDKs)
  1. 建立Create_Event_Action請求。

  2. 請求中包含以下內容:

    • Action

      • ExportRevisionToS3

        • Encryption

          • KmsKeyArn

          • Type

      • RevisionDestination

        • Bucket

        • KeyPattern

    • Event

      • RevisionPublished

        • DataSetId

  3. 如有必要,請修改關鍵模式。Amazon S3 物件金鑰預設為金鑰模式{Revision.CreatedAt}/{Asset.Name}

    如需關鍵模式的詳細資訊,請參閱匯出修訂時的關鍵模式

    若要確認符合 S3 儲存貯體政策許可的先決條件,會將具有命名格式_ADX-TEST-ACCOUNTID#的物件新增至 S3 儲存貯體。

匯出修訂時的關鍵模式

匯出修訂時,每個資產都會成為 S3 儲存貯體中的物件。物件的名稱以您提供的索引鍵模式為基礎。您可以使用代表資產屬性的動態參考,為匯出期間自動產生的名稱建立樣式。使用下表所示的動態參照。

動態參考 描述
${Asset.Id} 資產的識別碼。
${Asset.Name} 資產的名稱。
${DataSet.Id} 要匯出之資料集的 ID。
${DataSet.Name} 要匯出之資料集的名稱。
${Revision.CreatedAt} 建立修訂的UTC日期和時間,格式如下:YYYY-MM——DDTHH: MM:。SSZ例如:2021-10-08T16:三十三:19.787 Z
${Revision.CreatedAt.Day} 建立修訂版本的當月日期。
${Revision.CreatedAt.Month} 建立修訂版本的月份。
${Revision.CreatedAt.Year} 建立修訂的年份。
${Revision.Id} 要匯出之修訂的 ID。

您可以使用這些動態參考來建立資產名稱的關鍵模式。您必須至少包括兩個動Asset態參照中的一個,即${Asset.Name}${Asset.Id}

例如,使用${Revision.Id}/${Asset.Name}做為金鑰模式會導致 Amazon S3 物件使用修訂 ID 和資產名稱 (以斜線分隔) 做為物件名稱。

如果您匯出具有兩個名為asset1testRevisionId的資產 ID 的修訂版asset2,資產會匯出到 Amazon S3 中的下列位置:

  • <bucket>/testRevisionId/asset1

  • <bucket>/testRevisionId/asset2

注意

產生的物件必須具有唯一的名稱。如果它們的名稱與 S3 儲存貯體中的現有物件具有相同的名稱,則匯出將覆寫現有物件。如果您要匯出的修訂具有非唯一的名稱 (例如,兩個名稱相同的資產),匯出將會失敗。唯一唯一的動態參考是${Asset.Id}