本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
CREATETABLEAmazon 中的命令 QLDB
重要
支援結束通知：現有客戶將能夠使用 Amazon，QLDB直到 2025 年 7 月 31 日終止支援為止。有關更多詳細信息，請參閱將 Amazon QLDB 分類帳遷移到 Amazon Aurora 郵政. SQL
在 AmazonQLDB，使用命CREATE TABLE令創建一個新的表。
表具有沒有命名空間的簡單名稱。QLDB支援開放式內容，且不會強制執行結構定義，因此您不會在建立資料表時定義屬性或資料類型。
注意
若要瞭解如何控制在分類帳中執行此 PartiQL 命令的存取權，請參閱Amazon 中的標準許可模式入門 QLDB。
語法
CREATE TABLEtable_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驅動程式執行此陳述式，請參閱開始使用驅動程式中的下列教學課程：
