本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
要求匯出分錄 QLDB
重要
支援結束通知:現有客戶將能夠使用 Amazon,QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息,請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL
Amazon QLDB 提供指API定日期和時間範圍以及指定 Amazon S3 儲存貯體目的地請求匯出日誌區塊。日誌匯出任務可以使用 Amazon Ion 格式的文字或二進位表示法或 L JSONines
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
下列類別中的教學課程程式碼提供建立匯出、檢查匯出狀態以及處理匯出輸出的範例。
類別 | 描述 |
---|---|
ExportJournal |
以 10 分鐘前的時間戳記範圍從範vehicle-registration 例分類帳匯出分錄區塊,直到現在為止。將輸出物件寫入指定的 S3 儲存貯體,或建立唯一儲存貯體 (如果未提供)。 |
DescribeJournalExport |
說明範vehicle-registration 例分類帳exportId 中指定的分錄匯出工作。 |
ListJournalExports |
傳回vehicle-registration 範例分類帳的分錄匯出工作說明清單。 |
ValidateQldbHashChain |
使用指exportId 定的驗證vehicle-registration 範例分類帳的雜湊鏈。如果未提供,請求新的導出用於哈希鏈驗證。 |
匯出工作到期日
已完成的分錄匯出工作需要 7 天的保留期限。在此限制到期後,系統會自動將它們硬刪除。此到期期限為硬性限制,無法變更。
刪除完成的匯出工作後,您將無法再使用QLDB主控台或下列作API業來擷取有關工作的中繼資料:
-
DescribeJournalS3Export
-
ListJournalS3Exports
-
ListJournalS3ExportsForLedger
但是,此到期日對匯出的資料本身沒有任何影響。所有中繼資料都會保留在匯出所撰寫的資訊清單檔案中。此到期日旨在為列出日誌匯出工作的作API業提供更順暢的體驗。QLDB移除舊的匯出工作,以確保您只能看到最近的匯出,而不必剖析多頁工作。