Comando CREATE TABLE no Amazon QLDB

No Amazon QLDB, use o comando CREATE TABLE para criar uma nova tabela.

As tabelas têm nomes simples e nenhum namespace. O QLDB oferece suporte a conteúdo aberto e não impõe esquema, portanto, você não define atributos ou tipos de dados ao criar tabelas.

nota

Para aprender a controlar o acesso para executar cada comando do PartiQL em um ledger, consulte Introdução ao modo de permissões padrão no Amazon QLDB.

Sintaxe

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

Parâmetros

table_name

O nome exclusivo da tabela a ser criada. Não deve existir já uma tabela ativa com o mesmo nome. As seguintes são nomeadas usando restrições de nomenclatura:

• As tags devem conter apenas 1-128 caracteres alfanuméricos ou sublinhados.

• Deve ter uma letra ou um sublinhado para o primeiro caractere.

• Pode ter qualquer combinação de caracteres alfanuméricos e sublinhados para os caracteres restantes.

• Diferencia maiúsculas de minúsculas.

• Não deve ser uma palavra reservada do QLDB PartiQL.

'key': 'value'

(Opcional) As tags a serem anexadas ao recurso de tabela durante a criação. Cada tag é definida como um par de valores-chave, em que a chave e o valor são indicados por aspas simples. Cada par de valores-chave é definido dentro de uma estrutura Amazon Ion que é indicada por acentos graves.

Atualmente, a marcação de tabelas na criação é suportada para ledgers STANDARD apenas no modo de permissões.

Valor de retorno

tableId— O ID exclusivo da tabela que você criou.

Marcar tabelas na criação

nota

Atualmente, a marcação de tabelas na criação é suportada para ledgers apenas no modo de permissões STANDARD.

Opcionalmente, você pode marcar seus recursos de tabela especificando tags em uma instrução CREATE TABLE. Para ter mais informações sobre tags, consulte Como marcar recursos do Amazon QLDB. O exemplo a seguir cria uma tabela chamada Vehicle com a tag environment=production.

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

Marcar tabelas na criação requer acesso às ações qldb:PartiQLCreateTable e qldb:TagResource. Para saber mais sobre permissões para recursos do QLDB, consulte Como o Amazon QLDB funciona com o IAM.

Ao marcar os recursos no momento da criação, você elimina a necessidade de executar scripts personalizados de marcação após a criação do recurso. Depois que uma tabela é marcada, você pode controlar o acesso à tabela com base nessas tags. Por exemplo, você pode conceder acesso total somente a tabelas que tenham uma tag específica. Para ver um exemplo de política JSON, consulte Acesso total a todas as ações com base nas tags da tabela.

Exemplos

CREATE TABLE VehicleRegistration

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

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

Executando programaticamente usando o driver

Para saber como executar programaticamente essa instrução usando o driver QLDB, consulte os seguintes tutoriais em Conceitos básicos do driver:

• Java: Tutorial de início rápido | Referência de Cookbook

• .NET: Tutorial de início rápido | Referência de Cookbook

• Go: Tutorial de início rápido | Referência de Cookbook

• Node.js: Tutorial de início rápido | Referência de Cookbook

• Python: Tutorial de início rápido | Referência de Cookbook