Amazon QLDB 中的 CREATE TABLE 命令 - Amazon Quantum Ledger Database (Amazon QLDB)
语法参数返回值创建标记表示例使用驱动程序以编程方式运行

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon QLDB 中的 CREATE TABLE 命令

在 Amazon QLDB 中使用 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 MQ 如何与 IAM 协同工作。

通过在创建资源时对其进行标记，无需在创建资源后运行自定义标记脚本。标记表后，您可根据这些标签来控制对表的访问。例如：您只能向具有特定标签的表授予完全访问权限。有关 JSON 策略示例，请参阅基于表格标签对所有操作的完全访问权限。

示例

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

使用驱动程序以编程方式运行

要了解如何使用 QLDB 驱动程序以编程方式运行此语句，请参阅驱动程序入门中的以下教程：