要求匯出分錄 QLDB

重要

支援結束通知：現有客戶將能夠使用 Amazon，QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息，請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL

Amazon QLDB 提供指API定日期和時間範圍以及指定 Amazon S3 儲存貯體目的地請求匯出日誌區塊。日誌匯出任務可以使用 Amazon Ion 格式的文字或二進位表示法或 L JSONines 文字格式來寫入資料物件。您可以使用 AWS Management Console，一個 AWS SDK，或 AWS Command Line Interface (AWS CLI) 以建立匯出工作。

AWS Management Console

請遵循下列步驟，QLDB使用QLDB主控台提交中的分錄匯出請求。

要求匯出 (主控台)

登入 AWS Management Console，然後在 https://console.aws.amazon.com/q ldb 開啟 Amazon QLDB 主控台。
在導覽窗格中，選擇 [匯出]。
選擇 [建立匯出工作]。
在 [建立匯出工作] 頁面上，輸入下列匯出設定：
- 分類帳 — 您要匯出其分錄區塊的分類帳。
- 開始日期與時間 — 要匯出之日誌區塊範圍的國際標準時間 (UTC) 中的包含開始時間戳記。此時間戳記必須早於 [結束] 日期和時間。如果您提供的開始時間戳記早於分類帳CreationDateTime，則會將其QLDB預設為分類帳CreationDateTime。
- 結束日期與時間 — 要匯出之日誌區塊範圍的獨佔結束時間戳記 (UTC)。這個日期和時間不可能在 future。
- 日誌區塊的目的地 — 匯出任務寫入資料物件時所使用的 Amazon S3 儲存貯體和前置詞名稱。使用以下 Amazon S3 URI 格式。
```
s3://amzn-s3-demo-bucket/prefix/
```
  您必須為輸出物件指定 S3 儲存貯體名稱和選用的前置詞名稱。以下是範例。
```
s3://amzn-s3-demo-bucket/journalExport/
```
  儲存貯體名稱和前綴必須同時符合 Amazon S3 命名規則和慣例。如需儲存貯體命名的詳細資訊，請參閱 Amazon S3 開發人員指南中的儲存貯體限制和限制。如需索引鍵名稱前置詞的詳細資訊，請參閱物件索引鍵和中繼資料。
  
  注意
  不支援跨區域匯出。指定的 Amazon S3 儲存貯體必須位於相同 AWS 區域作為您的分類帳。
- S3 加密 — 匯出任務用於在 Amazon S3 儲存貯體中寫入資料的加密設定。若要進一步了解 Amazon S3 中的伺服器端加密選項，請參閱 Amazon S3 開發人員指南中的使用伺服器端加密保護資料。
  - 儲存貯體預設加密 — 使用指定 Amazon S3 儲存貯體的預設加密設定。
  - AES-256 — 搭配 Amazon S3 受管金鑰 (SSE-S3) 使用伺服器端加密。
  - AWS-KMS — 使用伺服器端加密 AWS KMS 託管密鑰（SSE-KMS）。
    
    如果您選擇此類型以及選擇其他 AWS KMS key選項時，您還必須以下列 Amazon 資源名稱 (ARN) 格式指定對稱加密KMS金鑰。
    
    arn:aws:kms:aws-region:account-id:key/key-id
- 服務存取 — 授與 Amazon S3 儲存貯體QLDB寫入許可的IAM角色。如果適用，IAM角色還必須授與使用KMS金鑰的QLDB權限。
  
  若要在要求日誌匯出QLDB時將角色傳遞給，您必須擁有對IAM角色資源執行iam:PassRole動作的權限。
  - 建立和使用新的服務角色 — 讓主控台為您建立具有指定 Amazon S3 儲存貯體所需許可的新角色。
  - 使用現有的服務角色 — 若要瞭解如何在中手動建立此角色IAM，請參閱匯出權限。
- 輸出格式 — 匯出分錄資料的輸出格式
  - 離子文本-（默認）Amazon 離子的文本表示
  - 離子二進制-Amazon 離子的二進制表示
  - JSON— 以換行符分隔JSON的文字格式
    
    如果您選擇JSON，請在匯出的資料物件JSON中QLDB向下轉換 Ion 日誌資料。如需詳細資訊，請參閱向下轉換為 JSON。
如果設定符合您的需求，請選擇 [建立匯出工作]。

完成匯出工作所需的時間，視資料大小而有所不同。如果您的要求提交成功，主控台會返回「匯出」主頁面，並列出匯出工作及其目前狀態。
您可以在 Amazon S3 主控台上看到您的匯出物件。

在開啟 Amazon S3 主控台https://console.aws.amazon.com/s3/。

若要進一步瞭解這些輸出物件的格式，請參閱分錄匯出輸出 QLDB。

注意

匯出工作在完成後七天到期。如需詳細資訊，請參閱匯出工作到期日。

QLDB API

您也可以通過使用 Amazon QLDB API 與 AWS SDK或 AWS CLI。 QLDBAPI提供下列作業供應用程式使用：

ExportJournalToS3— 將日期和時間範圍內的日誌內容從指定分類帳匯出到指定的 Amazon S3 儲存貯體。匯出任務可以將資料寫入為 Amazon Ion 格式的文字或二進位表示法，或使用 L JSON ines 文字格式的物件。
DescribeJournalS3Export— 傳回分錄匯出工作的詳細資訊。輸出包括其目前狀態、建立時間，以及原始匯出請求的參數。
ListJournalS3Exports— 傳回與目前相關聯之所有分類帳的分錄匯出工作說明清單 AWS 帳戶和地區。每個匯出工作描述的輸出都包含傳回的相同詳細資訊DescribeJournalS3Export。
ListJournalS3ExportsForLedger— 傳回指定分類帳的日誌匯出工作說明清單。每個匯出工作描述的輸出都包含傳回的相同詳細資訊DescribeJournalS3Export。

如需這些API作業的完整描述，請參閱Amazon QLDB API 參考。

如需使用匯出分錄資料的相關資訊 AWS CLI，請參閱 AWS CLI 指令參考。

應用程式範例

有關基本導出操作的 Java 代碼示例，請參閱 GitHub 存儲庫 aws-樣amazon-qldb-dmv-sample本/-java。如需如何下載和安裝此範例應用程式的指示，請參閱安裝 Amazon QLDB Java 示例應用程序。請求匯出之前，請務必遵循中的步驟 1-3 爪哇教程來建立範例分類帳，並使用範例資料載入分類帳。

下列類別中的教學課程程式碼提供建立匯出、檢查匯出狀態以及處理匯出輸出的範例。

類別	描述
ExportJournal	以 10 分鐘前的時間戳記範圍從範`vehicle-registration`例分類帳匯出分錄區塊，直到現在為止。將輸出物件寫入指定的 S3 儲存貯體，或建立唯一儲存貯體 (如果未提供)。
DescribeJournalExport	說明範`vehicle-registration`例分類帳`exportId`中指定的分錄匯出工作。
ListJournalExports	傳回`vehicle-registration`範例分類帳的分錄匯出工作說明清單。
ValidateQldbHashChain	使用指`exportId`定的驗證`vehicle-registration`範例分類帳的雜湊鏈。如果未提供，請求新的導出用於哈希鏈驗證。

匯出工作到期日

已完成的分錄匯出工作需要 7 天的保留期限。在此限制到期後，系統會自動將它們硬刪除。此到期期限為硬性限制，無法變更。

刪除完成的匯出工作後，您將無法再使用QLDB主控台或下列作API業來擷取有關工作的中繼資料：

DescribeJournalS3Export
ListJournalS3Exports
ListJournalS3ExportsForLedger

但是，此到期日對匯出的資料本身沒有任何影響。所有中繼資料都會保留在匯出所撰寫的資訊清單檔案中。此到期日旨在為列出日誌匯出工作的作API業提供更順暢的體驗。QLDB移除舊的匯出工作，以確保您只能看到最近的匯出，而不必剖析多頁工作。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

匯出分錄資料

匯出輸出