Tablestore:Collapse (distinct)

Pré-requisitos

• Instância OTSClient inicializada. Para mais informações, consulte Inicializar uma instância OTSClient.

• Tabela de dados criada e preenchida. Para mais informações, consulte Criar tabelas de dados e Gravar dados.

• Índice de pesquisa criado para a tabela de dados. Para mais informações, consulte Criar índices de pesquisa.

Observações

• O recurso de collapse oferece suporte à paginação apenas pelo método Offset+Limit. O método de token não é compatível.

• Se você usar agregação estatística e o recurso de collapse no mesmo conjunto de resultados, a agregação estatística será aplicada antes do colapso dos dados.

• Após o uso do recurso de collapse, o número total de grupos retornados corresponde à soma de Offset e Limit. O máximo de grupos que podem ser retornados é 100.000.

• O número total de linhas retornadas reflete a quantidade de linhas correspondentes antes da aplicação do collapse. Não é possível obter o número total de grupos após o colapso.

Parâmetros

Exemplos

O exemplo abaixo consulta todas as linhas de uma tabela e aplica o collapse no conjunto de resultados com base na coluna pk0, garantindo que apenas uma linha por valor único de pk0 seja retornada.

/// <summary>
/// Collapses the result set by the pk0 column.
/// </summary>
/// <param name="otsClient"></param>
public static void UseCollapse(OTSClient otsClient)
{
    MatchAllQuery matchAllQuery = new MatchAllQuery();

    Collapse collapse = new Collapse();
    collapse.FieldName = "pk0";

    SearchQuery searchQuery = new SearchQuery();
    searchQuery.Query = matchAllQuery;
    searchQuery.Collapse = collapse;

    SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);

    SearchResponse searchResponse = otsClient.Search(searchRequest);

    foreach (Row row in searchResponse.Rows)
    {
        Console.WriteLine(JsonConvert.SerializeObject(row));
    }
}

FAQ

• O que fazer quando nenhum dado é encontrado ao chamar a operação Search?

• Como aumentar o valor do parâmetro limit para 1000 ao chamar a operação Search do índice de pesquisa para consultar dados?

• Por que um token se torna inválido durante a paginação em uma consulta baseada em índice de pesquisa?

Referências

• Ao consultar dados com um índice de pesquisa, utilize os seguintes métodos: consulta de termo, consulta de termos, consulta match all, consulta match, consulta match phrase, consulta de prefixo, consulta de intervalo, consulta com curinga, consulta booleana, consulta geográfica, consulta aninhada e consulta exists. Combine diferentes métodos para consultar dados sob múltiplas dimensões conforme suas necessidades de negócio.

  Para ordenar ou paginar as linhas que atendem aos critérios de consulta, utilize os recursos de classificação e paginação. Para mais informações, consulte Classificação e paginação.

  Utilize o recurso de collapse (distinct) para agrupar o conjunto de resultados com base em uma coluna específica. Assim, dados do tipo especificado aparecem apenas uma vez nos resultados da consulta. Para mais informações, consulte Collapse (distinct).

• Para analisar dados em uma tabela, utilize o recurso de agregação da operação Search ou execute instruções SQL. É possível obter valores mínimos e máximos, somas e o número total de linhas. Para mais informações, consulte Agregação e Consulta SQL.

• Caso precise obter todas as linhas correspondentes aos critérios de consulta sem ordená-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Varredura paralela.