Todos os produtos
Search
Central de documentação

MaxCompute:Modify and view tables

Última atualização: Aug 21, 2026

Utilize instruções SQL para modificar propriedades de tabelas, renomear tabelas, limpar dados e visualizar metadados de tabelas no MaxCompute.

A tabela a seguir lista os comandos para modificar e visualizar tabelas.

Categoria do comando

Tipo

Descrição

Função necessária

Ações

Modificar uma tabela

{{XREF_0}}

Altera o proprietário de uma tabela.

Proprietário do projeto.

Execute estes comandos usando os seguintes métodos:

  • {{XREF_1}}

  • {{XREF_2}}

  • {{XREF_3}}

  • {{XREF_4}}

  • {{XREF_5}}

{{XREF_6}}

Modifica o comentário de uma tabela.

Usuários com o privilégio ALTER na tabela.

{{XREF_7}}

Define o LastModifiedTime de uma tabela para a hora atual.

{{XREF_8}}

Adiciona ou remove propriedades de clustering de uma tabela.

{{XREF_9}}

Renomeia uma tabela.

{{XREF_10}}

Limpa todos os dados de uma tabela não particionada.

{{XREF_11}}

Limpa dados de colunas em uma tabela regular.

Visualizar uma tabela

{{XREF_12}}

Visualiza informações sobre uma tabela interna, externa, com cluster ou transacional.

Usuários com o privilégio DESCRIBE na tabela.

{{XREF_13}}

Visualiza a instrução DDL de uma tabela.

{{XREF_14}}

Lista todas as tabelas em um projeto ou filtra por padrão de nome.

Usuários com o privilégio LIST no projeto.

{{XREF_15}}

Lista todas as tabelas externas em um projeto ou filtra por padrão de nome.

Alterar o proprietário da tabela

Altera o proprietário de uma tabela para uma conta de usuário diferente do Alibaba Cloud ou RAM.

Importante

Somente o proprietário do projeto ou um usuário com a função Super_Administrator pode executar este comando.

Sintaxe

ALTER TABLE <table_name> CHANGEOWNER TO <new_owner>;

Parâmetros

Parâmetro

Obrigatório

Descrição

table_name

Sim

O nome da tabela.

new_owner

Sim

A conta do novo proprietário.

  • Para alterar o proprietário para um usuário RAM, use o formato: RAM$<UID>:<ram_name>, onde UID é o ID da conta do Alibaba Cloud, e ram_name é o nome de exibição do usuário RAM.

Nota

Para alterar o proprietário da tabela para um usuário RAM, certifique-se de que o usuário RAM esteja adicionado ao projeto que contém a tabela.

Exemplos

Os exemplos nesta seção utilizam a tabela sale_detail. Para criá-la, consulte {{XREF_16}}.

  • Altere o proprietário da tabela sale_detail para ALIYUN$xxx@aliyun.com.

    ALTER TABLE sale_detail CHANGEOWNER TO 'ALIYUN$xxx@aliyun.com';
  • Altere o proprietário da tabela sale_detail para o usuário RAM chamado ram_test.

    ALTER TABLE sale_detail CHANGEOWNER TO 'RAM$13xxxxxxxxxxx:ram_test';

Modificar o comentário de uma tabela

Modifica o comentário de uma tabela.

Sintaxe

ALTER TABLE <table_name> SET COMMENT '<new_comment>';

Parâmetros

Parâmetro

Obrigatório

Descrição

table_name

Sim

O nome da tabela.

new_comment

Sim

O novo comentário.

Exemplos

ALTER TABLE sale_detail SET COMMENT 'new comment for table sale_detail';

Execute DESC <table_name> para verificar o comment atualizado.

+------------------------------------------------------------------------------------+
| Owner:                    ALIYUN$sant****.aliyunid.com                  |
| Project:                  ani****                                               |
| Schema:                   default                                                  |
| TableComment: new comment for table sale_detail                                    |
+------------------------------------------------------------------------------------+

Atualizar a última hora de modificação de uma tabela

A operação TOUCH define o LastModifiedTime de uma tabela para a hora atual. Isso altera o LastModifiedTime da tabela, fazendo com que o MaxCompute considere os dados da tabela como modificados e reinicie o cálculo do ciclo de vida do LastModifiedTime.

Sintaxe

ALTER TABLE <table_name> TOUCH;

Parâmetros

table_name: Obrigatório. O nome da tabela a ser atualizada.

Exemplos

ALTER TABLE sale_detail TOUCH;

Modificar propriedades de cluster da tabela

Use ALTER TABLE para adicionar ou remover propriedades de cluster em tabelas particionadas.

Sintaxe

  • Adicione uma propriedade de hash cluster a uma tabela:

    ALTER TABLE <table_name> 
    [CLUSTERED BY (<col_name> [, <col_name>, ...]) 
    [SORTED BY (<col_name> [ASC | DESC] [, <col_name> [ASC | DESC] ...])] 
    INTO <number_of_buckets> BUCKETS];
  • Remova a propriedade de hash cluster de uma tabela:

    ALTER TABLE <table_name> NOT CLUSTERED;
  • Adicione uma propriedade de range cluster a uma tabela. O número de buckets é opcional. Se omitido, o sistema determina a contagem ideal com base no volume de dados.

    ALTER TABLE <table_name> 
    [RANGE CLUSTERED BY (<col_name> [, <col_name>, ...]) 
    [SORTED BY (<col_name> [ASC | DESC] [, <col_name> [ASC | DESC] ...])] 
    INTO <number_of_buckets> BUCKETS];
  • Remova a propriedade de range cluster de uma tabela ou partição:

    ALTER TABLE <table_name> NOT CLUSTERED;
    ALTER TABLE <table_name> PARTITION <pt_spec> NOT CLUSTERED;
    Nota

    ALTER TABLE altera as propriedades de clustering apenas para tabelas particionadas. Para tabelas não particionadas, o clustering não pode ser alterado após a criação. A instrução ALTER TABLE aplica-se a tabelas existentes. Após adicionar uma nova propriedade de clustering, as novas partições são armazenadas com o clustering especificado.

    ALTER TABLE afeta apenas novas partições, incluindo aquelas geradas por INSERT OVERWRITE. As partições existentes permanecem inalteradas. É possível desativar e reativar o clustering com configurações diferentes para novas partições.

    ALTER TABLE afeta apenas novas partições. Não é possível especificar uma partição específica ao adicionar ou modificar uma propriedade de cluster.

Parâmetros

{{XREF_17}}.

Renomear uma tabela

Renomeia uma tabela sem modificar os dados.

Sintaxe

ALTER TABLE <table_name> RENAME TO <new_table_name>;

Parâmetros

Parâmetro

Obrigatório

Descrição

table_name

Sim

O nome da tabela a ser renomeada.

new_table_name

Sim

O novo nome da tabela. Ocorre um erro se já existir uma tabela chamada new_table_name.

Exemplos

ALTER TABLE sale_detail RENAME TO sale_detail_rename;

Limpar uma tabela não particionada

Remove todos os dados de uma tabela não particionada. Para limpar dados de partição, consulte {{XREF_18}}.

Formato do comando

TRUNCATE TABLE <table_name>;

Parâmetros

table_name: Obrigatório. O nome da tabela não particionada.

Limpar dados de colunas

O comando clear column limpa dados de colunas em uma tabela regular definindo os valores como NULL. Isso remove dados não utilizados do disco e reduz os custos de armazenamento.

Sintaxe

ALTER TABLE <table_name> [partition ( <pt_spec>[, <pt_spec>....] )]
  CLEAR COLUMN column1[, column2, column3, ...]
  [without touch];

Parâmetros

Parâmetro

Obrigatório

Descrição

table_name

Sim

O nome da tabela que contém as colunas a serem limpas.

column

Sim

O nome de uma ou mais colunas a serem limpas.

partition

Não

A partição a ser limpa. Se omitido, a operação aplica-se a todas as partições.

pt_spec

Não

A especificação da partição, no formato (partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...).

without touch

Não

Se especificado, o LastDataModifiedTime não é atualizado. Por padrão, o LastDataModifiedTime é atualizado.

Exemplos

-- Add partitions to the sale_detail table
ALTER TABLE sale_detail ADD PARTITION (sale_date='2023', region='china') PARTITION (sale_date='2024', region='shanghai');

-- Insert data into the partitioned table
INSERT INTO sale_detail PARTITION (sale_date='2023', region='china') VALUES ('s1','c1',100.1),('s2','c2',100.2),('s3','c3',100.3);
INSERT INTO sale_detail PARTITION (sale_date='2024', region='shanghai') VALUES ('null','c5',null),('s6','c6',100.4),('s7','c7',100.5);

-- Clear the shop_name column
ALTER TABLE sale_detail partition(sale_date='2023', region='china') CLEAR COLUMN shop_name;

{{XREF_19}} para limitações e exemplos adicionais.

Informações da tabela

Visualize informações sobre tabelas internas, externas, com cluster ou transacionais. Para visualizar dados da tabela, use {{XREF_20}}.

Sintaxe do comando

  • Visualize informações básicas da tabela:

    DESC <table_name> [PARTITION (<pt_spec>)]; 
  • Visualize informações estendidas, incluindo nulabilidade de colunas, para tabelas externas, com cluster, transacionais ou internas:

    -- View extended information for external, clustered, transactional, or internal tables.
    DESC EXTENDED <table_name>; 

Parâmetros

Parâmetro

Obrigatório

Descrição

table_name

Sim

O nome da tabela a ser visualizada.

pt_spec

Não

A partição a ser visualizada em uma tabela particionada. O formato é (partition_col1 = partition_col_value1, partition_col2 = partition_col_value2, ...).

Exemplos

Nota

Os exemplos a seguir usam tabelas criadas em {{XREF_21}}.

  • Visualize informações sobre a tabela test1.

    DESC test1;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$maoXXX@alibaba-inc.com | Project: $project_name                      |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2020-11-16 17:47:48                                      |
    | LastDDLTime:              2020-11-16 17:47:48                                      |
    | LastModifiedTime:         2020-11-16 17:47:48                                      |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field           | Type       | Label | Comment                                     |
    +------------------------------------------------------------------------------------+
    | key             | string     |       |                                             |
    +------------------------------------------------------------------------------------+
  • Visualize informações sobre a tabela sale_detail.

    DESC sale_detail;

    Clique para expandir e visualizar o resultado da execução

    +--------------------------------------------------------------------+
    | Owner: ALIYUN$maoXXX@alibaba-inc.com | Project: $project_name      |
    | TableComment:                                                      |
    +--------------------------------------------------------------------+
    | CreateTime:               2017-06-28 15:05:17                      |
    | LastDDLTime:              2017-06-28 15:05:17                      |
    | LastModifiedTime:         2017-06-28 15:05:17                      |
    +--------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                  |
    +--------------------------------------------------------------------+
    | Native Columns:                                                    |
    +--------------------------------------------------------------------+
    | Field           | Type       | Label | Comment                     |
    +--------------------------------------------------------------------+
    | shop_name       | string     |       |                             |
    | customer_id     | string     |       |                             |
    | total_price     | double     |       |                             |
    +--------------------------------------------------------------------+
    | Partition Columns:                                                 |    
    +--------------------------------------------------------------------+
    | sale_date       | string     |                                     |
    | region          | string     |                                     |
    +--------------------------------------------------------------------+
  • Visualize informações detalhadas sobre a tabela sale_detail_ctas1.

    DESC extended sale_detail_ctas1;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$maoXXX@alibaba-inc.com | Project: $project_name                      |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2021-07-07 15:29:53                                      |
    | LastDDLTime:              2021-07-07 15:29:53                                      |
    | LastModifiedTime:         2021-07-07 15:29:53                                      |
    | Lifecycle:                10                                                       |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
    +------------------------------------------------------------------------------------+
    | shop_name | string |       |               | true     | NULL         |              |
    | customer_id | string |       |               | true     | NULL         |              |
    | total_price | double |       |               | true     | NULL         |              |
    | sale_date | string |       |               | true     | NULL         |              |
    | region   | string |       |               | true     | NULL         |              |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    | TableID:                  98cb8a38733c49eabed4735173818147                         |
    | IsArchived:               false                                                    |
    | PhysicalSize:             0                                                        |
    | FileNum:                  0                                                        |
    | StoredAs:                 AliOrc                                                   |
    | CompressionStrategy:      normal                                                   |
    +------------------------------------------------------------------------------------+

    sale_date e region são colunas regulares, não colunas de partição.

  • Visualize informações sobre a tabela sale_detail_ctas2.

    DESC sale_detail_ctas2;

    Clique para expandir e visualizar o resultado da execução

    +--------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name       |
    | TableComment:                                                      |
    +--------------------------------------------------------------------+
    | CreateTime:               2017-06-28 15:42:17                      |
    | LastDDLTime:              2017-06-28 15:42:17                      |
    | LastModifiedTime:         2017-06-28 15:42:17                      |
    +--------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                  |
    +--------------------------------------------------------------------+
    | Native Columns:                                                    |
    +--------------------------------------------------------------------+
    | Field           | Type       | Label | Comment                     |
    +--------------------------------------------------------------------+
    | shop_name       | string     |       |                             |
    | customer_id     | string     |       |                             |
    | total_price     | double     |       |                             |
    | sale_date       | string     |       |                             |
    | region          | string     |       |                             |
    +--------------------------------------------------------------------+
  • Visualize informações detalhadas sobre a tabela sale_detail_like.

    DESC extended sale_detail_like;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name                       |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2021-07-07 15:40:38                                      |
    | LastDDLTime:              2021-07-07 15:40:38                                      |
    | LastModifiedTime:         2021-07-07 15:40:38                                      |
    | Lifecycle:                10                                                       |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
    +------------------------------------------------------------------------------------+
    | shop_name | string |       |               | true     | NULL         |              |
    | customer_id | string |       |               | true     | NULL         |              |
    | total_price | double |       |               | true     | NULL         |              |
    +------------------------------------------------------------------------------------+
    | Partition Columns:                                                                 |
    +------------------------------------------------------------------------------------+
    | sale_date       | string     |                                                     |
    | region          | string     |                                                     |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    | TableID:                  61782ff7713f426e9d6f91d5deeac99a                         |
    | IsArchived:               false                                                    |
    | PhysicalSize:             0                                                        |
    | FileNum:                  0                                                        |
    | StoredAs:                 AliOrc                                                   |
    | CompressionStrategy:      normal                                                   |
    +------------------------------------------------------------------------------------+

    sale_detail_like possui as mesmas colunas e partições que sale_detail, mas com um ciclo de vida diferente.

    Nota

    O valor Size retornado por DESC <table_name>; inclui dados da lixeira. Para excluí-los, execute primeiro PURGE TABLE <table_name>; e depois execute DESC <table_name>; novamente. Execute SHOW recyclebin; para visualizar detalhes da lixeira.

  • Visualize informações sobre a tabela test_newtype.

    DESC test_newtype;

    Clique para expandir e visualizar o resultado da execução

    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field           | Type       | Label | Comment                                     |
    +------------------------------------------------------------------------------------+
    | c1              | tinyint    |       |                                             |
    | c2              | smallint   |       |                                             |
    | c3              | int        |       |                                             |
    | c4              | bigint     |       |                                             |
    | c5              | float      |       |                                             |
    | c6              | double     |       |                                             |
    | c7              | decimal    |       |                                             |
    | c8              | binary     |       |                                             |
    | c9              | timestamp  |       |                                             |
    | c10             | array<map<bigint,bigint>> |       |                              |
    | c11             | map<string,array<bigint>> |       |                              |
    | c12             | struct<s1:string,s2:bigint> |       |                            |
    | c13             | varchar(20) |       |                                            |
    +------------------------------------------------------------------------------------+
    
    OK
  • Visualize informações sobre a tabela t1, que é não particionada e possui hash cluster. As propriedades de cluster aparecem na seção Extended Info.

    DESC extended t1;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name                       |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2020-11-16 18:00:56                                      |
    | LastDDLTime:              2020-11-16 18:00:56                                      |
    | LastModifiedTime:         2020-11-16 18:00:56                                      |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
    +------------------------------------------------------------------------------------+
    | a        | string |       |               | true     | NULL         |              |
    | b        | string |       |               | true     | NULL         |              |
    | c        | bigint |       |               | true     | NULL         |              |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    | TableID:                  e6b06f705dc34a36a5b72e5af486cab7                         |
    | IsArchived:               false                                                    |
    | PhysicalSize:             0                                                        |
    | FileNum:                  0                                                        |
    | StoredAs:                 AliOrc                                                   |
    | CompressionStrategy:      normal                                                   |
    | ClusterType:              hash                                                     |
    | BucketNum:                1024                                                     |
    | ClusterColumns:           [c]                                                      |
    | SortColumns:              [c ASC]                                                  |
    +------------------------------------------------------------------------------------+
    
    OK
  • Visualize informações sobre a tabela t2, que é particionada e possui hash cluster. As propriedades de cluster aparecem na seção Extended Info.

    DESC EXTENDED t2;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name                       |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime: 2017-12-25 11:18:26                                                    |
    | LastDDLTime: 2017-12-25 11:18:26                                                   |
    | LastModifiedTime: 2017-12-25 11:18:26                                              |
    | Lifecycle: 2                                                                       |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES | Size: 0                                                       |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field | Type   | Label | Comment                                                   |
    +------------------------------------------------------------------------------------+
    | a     | string |       |                                                           |
    | b     | string |       |                                                           |
    | c     | bigint |       |                                                           |
    +------------------------------------------------------------------------------------+
    | Partition Columns:                                                                 |
    +------------------------------------------------------------------------------------+
    | dt    | string |                                                                   |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    | TableID: 91a3395d3ef64b4d9ee1d2852755                                              |
    | IsArchived: false                                                                  |
    | PhysicalSize: 0                                                                    |
    | FileNum: 0                                                                         |
    | ClusterType: hash                                                                  |
    | BucketNum: 1024                                                                    |
    | ClusterColumns: [c]                                                                |
    | SortColumns: [c ASC]                                                               |
    +------------------------------------------------------------------------------------+
    
    OK
  • Visualize informações sobre a tabela t3, que é não particionada e possui range cluster. As propriedades de cluster aparecem na seção Extended Info.

    DESC extended t3;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name                       |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2020-11-16 18:01:05                                      |
    | LastDDLTime:              2020-11-16 18:01:05                                      |
    | LastModifiedTime:         2020-11-16 18:01:05                                      |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
    +------------------------------------------------------------------------------------+
    | a        | string |       |               | true     | NULL         |              |
    | b        | string |       |               | true     | NULL         |              |
    | c        | bigint |       |               | true     | NULL         |              |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    | TableID:                  38d170aca2684f4baadbbe1931a6ae1f                         |
    | IsArchived:               false                                                    |
    | PhysicalSize:             0                                                        |
    | FileNum:                  0                                                        |
    | StoredAs:                 AliOrc                                                   |
    | CompressionStrategy:      normal                                                   |
    | ClusterType:              range                                                    |
    | BucketNum:                1024                                                     |
    | ClusterColumns:           [c]                                                      |
    | SortColumns:              [c ASC]                                                  |
    +------------------------------------------------------------------------------------+
    
    OK
  • Visualize informações sobre a tabela t4, que é particionada e possui range cluster. As propriedades de cluster aparecem na seção Extended Info.

    DESC extended t4;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@alibaba-inc.com | Project: $project_name                       |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2020-11-16 19:17:48                                      |
    | LastDDLTime:              2020-11-16 19:17:48                                      |
    | LastModifiedTime:         2020-11-16 19:17:48                                      |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
    +------------------------------------------------------------------------------------+
    | a        | string |       |               | true     | NULL         |              |
    | b        | string |       |               | true     | NULL         |              |
    | c        | bigint |       |               | true     | NULL         |              |
    +------------------------------------------------------------------------------------+
    | Partition Columns:                                                                 |
    +------------------------------------------------------------------------------------+
    | dt              | string     |                                                     |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    | TableID:                  6ebc3432e283449188c861427bcd6ee4                         |
    | IsArchived:               false                                                    |
    | PhysicalSize:             0                                                        |
    | FileNum:                  0                                                        |
    | StoredAs:                 AliOrc                                                   |
    | CompressionStrategy:      normal                                                   |
    | ClusterType:              range                                                    |
    | BucketNum:                0                                                        |
    | ClusterColumns:           [c]                                                      |
    | SortColumns:              [c ASC]                                                  |
    +------------------------------------------------------------------------------------+
    
    OK
  • Verifique se a tabela não particionada t5 é uma tabela transacional.

    Nota

    Use o {{XREF_22}} (versão 0.35.4 ou posterior) para verificar se uma tabela é transacional. Outras ferramentas ou versões mais antigas do cliente podem não exibir essa informação.

    DESC extended t5;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@aliyun.com | Project: $project_name                            |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2021-02-18 10:56:27                                      |
    | LastDDLTime:              2021-02-18 10:56:27                                      |
    | LastModifiedTime:         2021-02-18 10:56:27                                      |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field    | Type   | Label | ExtendedLabel | Nullable | DefaultValue | Comment      |
    +------------------------------------------------------------------------------------+
    | id       | bigint |       |               | true     | NULL         |              |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    ...
    | Transactional:            true                                                     |
    +------------------------------------------------------------------------------------+
  • Verifique se a tabela particionada t6 é uma tabela transacional.

    Nota

    Use o {{XREF_23}} (versão 0.35.4 ou posterior) para verificar se uma tabela é transacional. Outras ferramentas ou versões mais antigas do cliente podem não exibir essa informação.

    DESC extended t6;

    Clique para expandir e visualizar o resultado da execução

    +------------------------------------------------------------------------------------+
    | Owner: ALIYUN$xxxxx@test.aliyunid.com | Project: $project_name                     |
    | TableComment:                                                                      |
    +------------------------------------------------------------------------------------+
    | CreateTime:               2021-02-18 15:34:54                                      |
    | LastDDLTime:              2021-02-18 15:34:54                                      |
    | LastModifiedTime:         2021-02-18 15:34:54                                      |
    +------------------------------------------------------------------------------------+
    | InternalTable: YES      | Size: 0                                                  |
    +------------------------------------------------------------------------------------+
    | Native Columns:                                                                    |
    +------------------------------------------------------------------------------------+
    | Field           | Type       | Label | Comment                                     |
    +------------------------------------------------------------------------------------+
    | id              | bigint     |       |                                             |
    +------------------------------------------------------------------------------------+
    | Partition Columns:                                                                 |
    +------------------------------------------------------------------------------------+
    | ds              | string     |                                                     |
    +------------------------------------------------------------------------------------+
    | Extended Info:                                                                     |
    +------------------------------------------------------------------------------------+
    ...
    | Transactional:            true                                                     |
    +------------------------------------------------------------------------------------+

Instrução de criação de tabela

Retorna a instrução DDL usada para criar uma tabela.

Sintaxe

SHOW CREATE TABLE <table_name>;

Parâmetros

table_name: Obrigatório. O nome da tabela de destino.

Exemplos

-- View the CREATE TABLE statement for the sale_detail table.
SHOW CREATE TABLE sale_detail;

Saída de exemplo:

CREATE TABLE IF NOT EXISTS max****.`default`.sale_detail(shop_name STRING, customer_id STRING, total_price DOUBLE)
PARTITIONED BY (sale_date STRING, region STRING) STORED AS ALIORC TBLPROPERTIES ('columnar.nested.type'='true');

Listar tabelas e views do projeto

Lista todas as tabelas, tabelas externas, views e views materializadas em um projeto, ou filtra por padrão de nome.

Formato do comando

-- List all tables and views in the project.
SHOW TABLES;
-- List tables and views whose names match the specified pattern.
SHOW TABLES LIKE '<pattern>';

Exemplos

-- List tables whose names match the 'sale*' pattern. The asterisk (*) is a wildcard for any sequence of characters.
SHOW TABLES LIKE 'sale*';              

Saída de exemplo:

ALIYUN$account_name:sale_detail
......
-- The system prompt is ALIYUN for an Alibaba Cloud account and RAM for a RAM user.

Listar tabelas externas

Lista todas as tabelas externas em um projeto ou filtra por padrão de nome.

Nota

SHOW EXTERNAL TABLES requer o cliente MaxCompute (odpscmd) versão 0.43.0 ou posterior.

Sintaxe

-- List all external tables in the project.
SHOW EXTERNAL TABLES;
-- List external tables that match a specified pattern.
SHOW EXTERNAL TABLES LIKE '<pattern>';

Exemplos

-- List external tables that match the 'a*' pattern. The asterisk (*) is a wildcard for any sequence of characters.
SHOW EXTERNAL TABLES LIKE 'a*';   

Saída de exemplo:

ALIYUN$account_name:a_et
......
-- The system prompt is ALIYUN for an Alibaba Cloud account and RAM for a RAM user.

Referências