Object Storage Service:Create a table

Notes

• Les noms de table ne peuvent contenir que des lettres minuscules, des chiffres et des traits de soulignement (_), et doivent commencer et se terminer par une lettre minuscule ou un chiffre.

• Les noms de table doivent être uniques au sein d'un namespace.

• Le paramètre --metadata accepte du JSON qui définit le schéma de la table Iceberg. Fournissez le JSON en ligne ou référencez un fichier local avec le préfixe file://.

• Le paramètre --format prend uniquement en charge la valeur ICEBERG.

Syntaxe

ossutil tables-api create-table --table-bucket-arn value --namespace value --name value --format value  [flags]

Syntaxe JSON pour --metadata :

{
  "iceberg": {
    "schema": {
      "fields": [
        {
          "id": 1,
          "name": "id",
          "type": "long",
          "required": true
        },
        {
          "id": 2,
          "name": "name",
          "type": "string",
          "required": false
        },
        {
          "id": 3,
          "name": "created_at",
          "type": "timestamp",
          "required": false
        }
      ]
    }
  }
}

Attributs des champs :

• id : Entier incrémentiel unique.

• name : Nom du champ.

• type : Type de données. Types pris en charge : long, string, int, boolean, float, double et timestamp.

• required : Indique si le champ est obligatoire. Si la valeur est true, le champ ne peut pas être nul.

Exemples

• Créez une table Iceberg nommée my_table dans le namespace my_namespace avec un schéma JSON en ligne.

  ossutil tables-api create-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --format ICEBERG --metadata '{"iceberg":{"schema":{"fields":[{"id":1,"name":"id","type":"long","required":true},{"id":2,"name":"data","type":"string"}]}}}'

• Créez une table Iceberg à partir d'un fichier local de métadonnées JSON. Enregistrez le schéma dans table_metadata.json, puis référencez-le avec le préfixe file://.

  ossutil tables-api create-table --table-bucket-arn acs:osstables:cn-hangzhou:1234567890:bucket/my-table-bucket --namespace my_namespace --name my_table --format ICEBERG --metadata file://table_metadata.json