Todos os produtos
Search
Central de documentação

Tablestore:Consultar informações de uma tabela

Última atualização: Jul 03, 2026

Recupera informações do esquema da tabela, incluindo nomes e tipos de campos, ao executar a instrução DESCRIBE.

Nota

Para obter a sintaxe completa da instrução DESCRIBE, consulte Consultar informações de tabelas.

Pré-requisitos

Antes de começar, verifique se você tem:

Observações de uso

O recurso de consulta SQL exige o Tablestore SDK for .NET V5.0.0 ou posterior.

Para detalhes sobre as versões, consulte Histórico de versões do Tablestore SDK for .NET .

Parâmetros

Parâmetro

Descrição

query

Instrução SQL a ser executada. Para consultar informações da tabela, use DESCRIBE <table_name> ou DESC <table_name>.

Exemplos

O exemplo a seguir executa a instrução describe test_table e imprime o esquema e cada linha do conjunto de resultados. Cada linha contém seis colunas na seguinte ordem: nome do campo, tipo do campo, restrição de nulo, valor padrão, sinalizador de chave primária e sinalizador de chave de partição.

/// <summary>
/// Query information about a table.
/// </summary>
/// <param name="otsClient"></param>
public static void DescribeTable(OTSClient otsClient)
{
    SQLQueryRequest sqlQueryRequest = new SQLQueryRequest("describe test_table");

    SQLQueryResponse sqlQueryResponse = otsClient.SQLQuery(sqlQueryRequest);

    // Print the table schema as JSON.
    SQLTableMeta sqlTableMeta = sqlQueryResponse.GetSQLResultSet().GetSQLTableMeta();
    Console.WriteLine(JsonConvert.SerializeObject(sqlTableMeta.GetSchema()));

    // Iterate over the result set. Each row contains six columns:
    // index 0: field name, 1: field type, 2: null constraint,
    // 3: default value, 4: primary key flag, 5: partition key flag.
    ISQLResultSet resultSet = sqlQueryResponse.GetSQLResultSet();
    while (resultSet.HasNext())
    {
        ISQLRow row = resultSet.Next();
        Console.WriteLine(row.GetString(0) + " " + row.GetString(1) + " " + row.GetString(2) + " " +
                          row.GetString(3) + " " + row.GetString(4) + " " + row.GetString(5));
    }
}