Ao executar uma consulta com curinga, use os caracteres curinga asterisco () e ponto de interrogação (?) na consulta para pesquisar dados. O asterisco () corresponde a uma string de qualquer tamanho antes, depois ou no meio de um termo de pesquisa. O ponto de interrogação (?) corresponde a um único caractere em uma posição específica. A string pode começar com um asterisco () ou um ponto de interrogação (?). Por exemplo, ao pesquisar a string "tablee", o termo "tablestore" será correspondido.
Se o padrão de consulta for *word* (equivalente a WHERE field_a LIKE '%word%' em SQL), use o recurso de consultas com curinga baseadas em token para obter um melhor desempenho. O desempenho não diminui à medida que o tamanho dos dados aumenta.
Para usar o operador NOT LIKE, é necessário usar o WildcardQuery em conjunto com o must_not_queries do BoolQuery.
Pré-requisitos
Uma instância do OTSClient inicializada. Para mais informações, consulte Initialize an OTSClient instance.
Uma tabela de dados criada e com dados gravados. Para mais informações, consulte Create a data table e Write data.
Um índice de pesquisa criado para a tabela de dados. Para mais informações, consulte Create a search index.
Parâmetros
|
Parâmetro |
Descrição |
|
table_name |
O nome da tabela de dados. |
|
index_name |
O nome do índice de pesquisa. |
|
offset |
A posição a partir da qual a consulta atual começa. |
|
limit |
O número máximo de linhas que a consulta atual deve retornar. |
|
get_total_count |
Define se o número total de linhas que atendem às condições da consulta será retornado. O valor padrão deste parâmetro é false, o que indica que o número total de linhas correspondentes não é retornado. Definir o parâmetro get_total_count como true compromete o desempenho da consulta. |
|
query_type |
O tipo de consulta. Defina o tipo de consulta como |
|
field_name |
O nome da coluna a ser consultada. |
|
value |
A string que contém caracteres curinga. A string não pode exceder 32 caracteres de comprimento. |
|
sort |
O método usado para classificar as linhas na resposta. Para mais informações, consulte Sorting and paging. |
|
columns_to_get |
Define se todas as colunas de cada linha que atende às condições da consulta serão retornadas. Configure return_type e return_names para este parâmetro.
|
Exemplos
O código de exemplo a seguir mostra como consultar dados que correspondem à condição key* na coluna keyword de uma tabela.
$request = array(
'table_name' => 'php_sdk_test',
'index_name' => 'php_sdk_test_search_index',
'search_query' => array(
'offset' => 0,
'limit' => 2,
'get_total_count' => true,
'query' => array(
'query_type' => QueryTypeConst::WILDCARD_QUERY,
'query' => array(
'field_name' => 'keyword',
'value' => 'key*'
)
),
'sort' => array(
array(
'field_sort' => array(
'field_name' => 'keyword',
'order' => SortOrderConst::SORT_ORDER_ASC
)
),
)
),
'columns_to_get' => array(
'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
'return_names' => array('keyword')
)
);
$response = $otsClient->search($request);Perguntas frequentes
Referências
-
Ao usar um índice de pesquisa para consultar dados, você pode utilizar os seguintes métodos de consulta: term query, terms query, match all query, match query, match phrase query, prefix query, range query, wildcard query, Boolean query, geo query, nested query e exists query. Utilize diferentes métodos de consulta para pesquisar dados de várias dimensões com base nos requisitos do seu negócio.
Para classificar ou paginar as linhas que atendem às condições da consulta, use o recurso de classificação e paginação. Para mais informações, consulte Sorting and paging.
Para recolher o conjunto de resultados com base em uma coluna específica, use o recurso de recolhimento (distinct). Dessa forma, os 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 de dados, como obter os valores extremos, a soma e o número total de linhas, execute operações de agregação ou instruções SQL. Para mais informações, consulte Aggregation e SQL query.
Para obter rapidamente todas as linhas que atendem às condições da consulta sem a necessidade de classificá-las, chame as operações ParallelScan e ComputeSplits para usar o recurso de varredura paralela. Para mais informações, consulte Parallel scan.