CREATETABLEcommande dans Amazon QLDB - Base de données Amazon Quantum Ledger (AmazonQLDB)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

CREATETABLEcommande dans Amazon QLDB

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Dans AmazonQLDB, utilisez la CREATE TABLE commande pour créer une nouvelle table.

Les tables ont des noms simples, sans espaces de noms. QLDBprend en charge le contenu ouvert et n'applique pas le schéma. Vous ne définissez donc pas d'attributs ou de types de données lors de la création de tables.

Note

Pour savoir comment contrôler l'accès afin d'exécuter cette commande partiQL dans un registre, consultez. Commencer à utiliser le mode d'autorisation standard sur Amazon QLDB

Syntaxe

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

Paramètres

table_name

Nom unique de la table à créer. Une table active portant le même nom ne doit pas déjà exister. Les contraintes de dénomination sont les suivantes :

  • Ne doit contenir que 1 à 128 caractères alphanumériques ou traits de soulignement.

  • Le premier caractère doit comporter une lettre ou un trait de soulignement.

  • Peut comporter n'importe quelle combinaison de caractères alphanumériques et de traits de soulignement pour les autres caractères.

  • Fait la distinction majuscules/minuscules.

  • Il ne doit pas s'agir d'un QLDB mot réservé partiQL.

'key': 'value'

(Facultatif) Les balises à associer à la ressource de table lors de la création. Chaque balise est définie comme une paire clé-valeur, la clé et la valeur étant chacune indiquées par des guillemets simples. Chaque paire clé-valeur est définie dans une structure Amazon Ion désignée par des backticks.

Le balisage des tables lors de leur création est actuellement pris en charge pour les registres en mode STANDARD autorisations uniquement.

Valeur renvoyée

tableId— L'ID unique de la table que vous avez créée.

Marquer les tables lors de leur création

Note

Le balisage des tables lors de leur création est actuellement pris en charge pour les registres en mode STANDARD autorisations uniquement.

Vous pouvez éventuellement baliser les ressources de votre table en spécifiant des balises dans une CREATE TABLE instruction. Pour en savoir plus sur les identifications, consultez Marquer les ressources Amazon QLDB. L'exemple suivant crée une table nommée Vehicle avec la baliseenvironment=production.

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

Le balisage des tables lors de leur création nécessite l'accès à la fois aux qldb:TagResource actions qldb:PartiQLCreateTable et. Pour en savoir plus sur les autorisations relatives QLDB aux ressources, consultezComment Amazon QLDB travaille avec IAM.

En attribuant des étiquettes aux ressources au moment de la création, vous pouvez supprimer la nécessité d'exécuter des scripts d'identification personnalisés après la création de ressources. Une fois qu'une table est balisée, vous pouvez contrôler l'accès à la table en fonction de ces balises. Par exemple, vous pouvez accorder un accès complet uniquement aux tables dotées d'une balise spécifique. Pour un exemple JSON de stratégie, voirAccès complet à toutes les actions en fonction des balises du tableau.

Exemples

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

Exécution par programmation à l'aide du pilote

Pour savoir comment exécuter cette instruction par programmation à l'aide du QLDB pilote, consultez les didacticiels suivants dans Getting started with the driver :