Criar uma tabela Iceberg | ossutil create-table - Object Storage Service: Central de Documentação do Alibaba Cloud

Observações

Os nomes das tabelas podem conter apenas letras minúsculas, dígitos e underscores (_). Devem começar e terminar com uma letra minúscula ou dígito.
O nome da tabela deve ser único dentro de um namespace.
O parâmetro --metadata aceita JSON que define o schema da tabela Iceberg. Forneça o JSON inline ou referencie um arquivo local com o prefixo file://.
O parâmetro --format aceita apenas ICEBERG.

Sintaxe

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

Parâmetro	Tipo	Descrição
--encryption-configuration	string	Configuração de criptografia do lado do servidor para a tabela, em formato JSON.
--format	string	Formato da tabela. Apenas `ICEBERG` é compatível.
--metadata	string	Metadados da tabela em formato JSON. Define o schema da tabela Iceberg e as informações dos campos.
--name	string	Nome da tabela. Deve conter apenas letras minúsculas, dígitos e underscores (_), começando e terminando com uma letra minúscula ou dígito.
--namespace	string	Namespace de destino da tabela.
--table-bucket-arn	string	Alibaba Cloud Resource Name (ARN) do table bucket. Formato: `acs:osstables:{region}:{uid}:bucket/{bucket-name}`.

Nota

Este comando corresponde à operação da API CreateTable.
Este comando oferece suporte a todas as Opções globais para ossutil.

Sintaxe JSON para --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
        }
      ]
    }
  }
}

Atributos dos campos:

id: Inteiro incremental exclusivo.
name: Nome do campo.
type: Tipo de dado. Tipos compatíveis: long, string, int, boolean, float, double e timestamp.
required: Indica se o campo é obrigatório. Se definido como true, o campo não pode ser nulo.

Exemplos

Crie uma tabela Iceberg chamada my_table no namespace my_namespace com um schema JSON inline.

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"}]}}}'

Crie uma tabela Iceberg a partir de um arquivo local de metadados JSON. Salve o schema em table_metadata.json e referencie-o com o prefixo 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