Consulta de informações de tabela de séries temporais - Tablestore SDK for Java - Tablestore: Central de Documentação do Alibaba Cloud

Use o Tablestore SDK for Java para consultar as configurações e o status de uma tabela de séries temporais, incluindo TTL, campos personalizados de identificador de série temporal, chaves primárias de campos de dados, analytical stores e índices Lastpoint.

Pré-requisitos

Instale o Tablestore SDK for Java e inicialize um cliente de séries temporais.

Descrição

Chame describeTimeseriesTable para obter as configurações e o status de uma tabela de séries temporais. A resposta também inclui listas de analytical stores e índices Lastpoint. Se nenhum recurso correspondente estiver configurado, o sistema retornará uma lista vazia.

public DescribeTimeseriesTableResponse describeTimeseriesTable(DescribeTimeseriesTableRequest request)

O exemplo a seguir consulta as configurações e o status da tabela example_timeseries_table e lê as informações de analytical store e índice Lastpoint.

TimeseriesClient timeseriesClient = client.asTimeseriesClient();

String tableName = "example_timeseries_table";
DescribeTimeseriesTableRequest request =
        new DescribeTimeseriesTableRequest(tableName);
DescribeTimeseriesTableResponse response =
        timeseriesClient.describeTimeseriesTable(request);

TimeseriesTableMeta tableMeta = response.getTimeseriesTableMeta();
System.out.println(tableMeta.getTimeseriesTableName());
System.out.println(tableMeta.getStatus());
System.out.println(tableMeta.getTimeseriesTableOptions().getTimeToLive());
System.out.println(tableMeta.getTimeseriesMetaOptions().getMetaTimeToLive());
System.out.println(tableMeta.getTimeseriesMetaOptions().getAllowUpdateAttributes());

for (TimeseriesAnalyticalStore store : response.getAnalyticalStores()) {
    System.out.println(store.getAnalyticalStoreName());
    System.out.println(store.getTimeToLive());
    System.out.println(store.getSyncOption());
}

for (TimeseriesLastpointIndex index : response.getLastpointIndexes()) {
    System.out.println(index.getLastpointIndexName());
}

Parâmetros

DescribeTimeseriesTableRequest contém o seguinte parâmetro.

Nome	Tipo	Descrição
timeseriesTableName (obrigatório)	`String`	Nome da tabela de séries temporais.

Resposta

DescribeTimeseriesTableResponse contém os seguintes campos específicos da operação.

Campo	Tipo	Descrição
`timeseriesTableMeta`	`TimeseriesTableMeta`	Chame `getTimeseriesTableMeta()` para obter as configurações e o status da tabela de séries temporais.
`analyticalStores`	`List<TimeseriesAnalyticalStore>`	Chame `getAnalyticalStores()` para obter os analytical stores. O sistema retorna uma lista vazia se nenhum analytical store tiver sido criado.
`lastpointIndexes`	`List<TimeseriesLastpointIndex>`	Chame `getLastpointIndexes()` para obter os índices Lastpoint. O sistema retorna uma lista vazia se nenhum índice Lastpoint tiver sido criado.

Informações da tabela de séries temporais

timeseriesTableMeta é do tipo TimeseriesTableMeta e contém os seguintes campos.

Campo	Tipo	Descrição
`timeseriesTableName`	`String`	Chame `getTimeseriesTableName()` para obter o nome da tabela de séries temporais.
`timeseriesTableOptions`	`TimeseriesTableOptions`	Chame `getTimeseriesTableOptions()` para obter as configurações de dados de séries temporais.
`timeseriesMetaOptions`	`TimeseriesMetaOptions`	Chame `getTimeseriesMetaOptions()` para obter as configurações de metadados de séries temporais.
`status`	`String`	Chame `getStatus()` para obter o status da tabela de séries temporais.
`timeseriesKeys`	`List<String>`	Chame `getTimeseriesKeys()` para obter os campos personalizados de identificador de série temporal. O sistema retorna uma lista vazia se nenhum campo personalizado estiver configurado.
`fieldPrimaryKeys`	`List<PrimaryKeySchema>`	Chame `getFieldPrimaryKeys()` para obter os campos de dados usados como chaves primárias. O sistema retorna uma lista vazia se nenhuma chave primária de campo de dados estiver configurada.

Configurações de dados de séries temporais

timeseriesTableMeta.timeseriesTableOptions é do tipo TimeseriesTableOptions e contém o seguinte campo.

Campo	Tipo	Descrição
`timeToLive`	`int`	Chame `getTimeToLive()` para obter o TTL dos dados de séries temporais em segundos. O valor `-1` indica que os dados não expiram.

Configurações de metadados de séries temporais

timeseriesTableMeta.timeseriesMetaOptions é do tipo TimeseriesMetaOptions e contém os seguintes campos.

Campo	Tipo	Descrição
`metaTimeToLive`	`int`	Chame `getMetaTimeToLive()` para obter o TTL dos metadados de séries temporais em segundos. O valor `-1` indica que os metadados não expiram.
`allowUpdateAttributes`	`boolean`	Chame `getAllowUpdateAttributes()` para verificar se as colunas de atributo dos metadados podem ser atualizadas.

Chaves primárias de campos de dados

Cada elemento em timeseriesTableMeta.fieldPrimaryKeys[] é do tipo PrimaryKeySchema e contém os seguintes campos.

Campo	Tipo	Descrição
`name`	`String`	Chame `getName()` para obter o nome do campo de dados.
`type`	`PrimaryKeyType`	Chame `getType()` para obter o tipo do campo de dados. Valores válidos: `INTEGER` e `STRING`.

Analytical stores

Cada elemento em analyticalStores[] é do tipo TimeseriesAnalyticalStore e contém os seguintes campos.

Campo	Tipo	Descrição
`analyticalStoreName`	`String`	Chame `getAnalyticalStoreName()` para obter o nome do analytical store.
`timeToLive`	`int`	Chame `getTimeToLive()` para obter o TTL dos dados no analytical store, em segundos. O valor `-1` indica que os dados não expiram.
`syncOption`	`AnalyticalStoreSyncType`	Chame `getSyncOption()` para obter o método de sincronização de dados.

Índices Lastpoint

Cada elemento em lastpointIndexes[] é do tipo TimeseriesLastpointIndex e contém o seguinte campo.

Campo	Tipo	Descrição
`lastpointIndexName`	`String`	Chame `getLastpointIndexName()` para obter o nome do índice Lastpoint.