CREATETABLEAmazon 中的命令 QLDB - Amazon Quantum 賬本數據庫（AmazonQLDB）
語法參數傳回值在建立表格時標記範例以編程方式使用驅動程序

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

CREATETABLEAmazon 中的命令 QLDB

重要

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

在 AmazonQLDB，使用命CREATE TABLE令創建一個新的表。

表具有沒有命名空間的簡單名稱。QLDB支援開放式內容，且不會強制執行結構定義，因此您不會在建立資料表時定義屬性或資料類型。

注意

若要瞭解如何控制在分類帳中執行此 PartiQL 命令的存取權，請參閱開始使用 Amazon 的標準許可模式 QLDB。

語法

CREATE TABLE table_name [ WITH (aws_tags = `{'key': 'value'}`) ]

參數

table_name

要建立的資料表的唯一名稱。具有相同名稱的活動表必須不存在。以下是命名條件約束：

  • 只能包含 1—128 個英數字元或底線。

  • 第一個字元必須有字母或底線。

  • 其餘字元可以包含英數字元和底線的任意組合。

  • 是區分大小寫的。

  • 不得為 QLDB PartiQL 保留字。

'key': 'value'

(選擇性) 建立期間要附加至表格資源的標籤。每個標籤都被定義為一個鍵值對，其中的鍵和值分別用單引號表示。每個鍵值對都在 Amazon Ion 結構內定義，該結構由反引號表示。

目前僅在STANDARD權限模式下，分類帳支援在建立時標記表格。

傳回值

tableId— 您所建立之表格的唯一 ID。

在建立表格時標記

注意

目前僅在STANDARD權限模式下，分類帳支援在建立時標記表格。

或者，您可以在CREATE TABLE陳述式中指定標籤來標記資料表資源。如需標籤的詳細資訊，請參閱標記 Amazon QLDB 資源。下列範例會建立以標籤命名Vehicle的資料表environment=production。

CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'production'}`)

在建立表格時標記表格需要存取qldb:PartiQLCreateTable和qldb:TagResource動作。若要進一步瞭解QLDB資源的權限，請參閱Amazon 如QLDB何與 IAM。

藉由在建立時為資源建立標籤，您可以消除在資源建立後執行自訂標籤指令碼的必要。在標記資料表之後，您可以根據這些標籤控制對資料表的存取。例如，您只能將完整存取權授與具有特定標籤的資料表。如需JSON策略範例，請參閱根據表格標籤對所有動作的完整存取權。

範例

CREATE TABLE VehicleRegistration
CREATE TABLE Vehicle WITH (aws_tags = `{'environment': 'development'}`)
CREATE TABLE Vehicle WITH (aws_tags = `{'key1': 'value1', 'key2': 'value2'}`)

以編程方式使用驅動程序

若要了解如何以程式設計方式使用QLDB驅動程式執行此陳述式，請參閱開始使用驅動程式中的下列教學課程：