OpenSearch:Quick Start

Pré-requisitos

1. Você deve ter uma conta Alibaba Cloud e ter concluído real-name verification.

2. Ao fazer login no console do Alibaba Cloud pela primeira vez, você será solicitado a crie um AccessKey.

   • É necessário ter um AccessKey da conta principal para crie e utilizar aplicações.

   • Após crie um AccessKey para a conta principal, você também pode crie um para um usuário RAM. Conceda as permissões necessárias ao usuário RAM. Para mais informações, consulte Access control rules.

Etapa 1: Adquira uma aplicação

Faça login no console do OpenSearch. No canto superior esquerdo, selecione OpenSearch-High-performance Search Edition. Na página instance management, clique em Create Instance.

Você pode adquirir uma aplicação com assinatura ou com pagamento conforme o uso.

Na página de aquisição, selecione uma região e zona de disponibilidade, como China (Shenzhen) ou China (Beijing), insira um nome de aplicação (que não pode ser alterado após a criação) e selecione uma preferência de cluster (dedicated cluster - general-purpose, dedicated cluster - compute-optimized, dedicated cluster - storage-optimized ou shared cluster - general-purpose).

Na página de aquisição, configure a capacidade de armazenamento (por exemplo, 100 GB), os recursos de computação (por exemplo, 800 LCU), o ciclo de faturamento (selecione uma duração de 1 a 6 meses e, opcionalmente, marque Auto-renewal), e o grupo de recursos (padrão: default resource group). Em seguida, clique em Buy Now para concluir o pedido.

Etapa 2: Configure a aplicação

Após a inicialização da aplicação, seu status muda para Pending. Clique em Configure para defina o schema da aplicação.

O assistente de configuração orienta você em quatro etapas: Application schema → Index schema → Data source → Finish. Na primeira etapa, escolha um método para crie o schema da aplicação. As opções disponíveis são Create from data source, Create manually, Create from template e Create by uploading documents. Após fazer sua seleção, clique em Next.

Defina o schema da aplicação

O schema da aplicação pode ser criado de quatro maneiras diferentes.

Métodos para defina o schema da aplicação:

1. Crie o schema da aplicação a partir de um modelo. Salve um schema de aplicação já configurado como modelo para crie novas aplicações com agilidade.

2. Crie o schema da aplicação fazendo upload de documentos. Faça upload de um arquivo de dados existente (somente no formato json). O sistema analisa o arquivo automaticamente para gerar um schema inicial da aplicação. Em seguida, redefina os tipos de campo e demais configurações conforme necessário.

3. Crie o schema da aplicação a partir de uma fonte de dados. Ideal para sincronizar dados de fontes como RDS e maxcompute. Esse método gera rapidamente um schema inicial com base na estrutura da tabela source, reduzindo o esforço manual e o risco de erros. Esta seção utiliza RDS como exemplo; o processo para outras fontes de dados é semelhante. Para mais detalhes, consulte Configurar uma fonte de dados.

   Selecione a aba Create from data source. No painel Select Data Source exibido à direita, selecione RDS e clique em + New Database Connection.

   Na caixa de diálogo Connect to Database, insira o RDS Instance ID, o Database Name, o Username e o Password, e clique em Connect.

4. Crie o schema da aplicação manualmente. Use este método quando as demais opções não se adequarem ao seu cenário.

   Na página Create manually, insira um nome de tabela (por exemplo, main) e selecione Primary table. Na área de definição de campos, defina os nomes dos campos (por exemplo, id e name), marque o botão primary key para um dos campos e escolha um tipo para cada campo (como INT ou LITERAL). Os tipos de campo selecionados influenciam a configuração dos campos de índice e atributo posteriormente. Clique em + para adicionar mais campos.

Defina o schema de índice

• Crie um índice para qualquer campo utilizado em uma cláusula query. Campos do tipo ponto flutuante não podem ser criados como índice. Para mais informações, consulte OpenSearch table schema.

• Crie campos de atributo para os campos utilizados em cláusulas filter, sort ou em funções.

• Tipos de campo com tokenização, como TEXT e SHORT_TEXT, não podem ser configurados como campos de atributo. Apenas tipos numéricos e não tokenizados — como int, int_array, float, float_array, double, double_array, literal e literal_array — podem ser configurados como campos de atributo.

  Na etapa Index schema, configure três seções: Index Fields, onde você defina o nome do índice, os campos incluídos e o método de análise (como chinese - general analysis ou keyword), por exemplo, query=default:"cloud search"; Attribute fields, que permite o uso dos campos em cláusulas filter, aggregate, sort e distinct, por exemplo, filter=id>100000; e Default Display Fields, que garante que os valores desses campos sejam retornados nos resultados de busca. Após concluir a configuração, clique em Next para configure a fonte de dados.

Sincronize a fonte de dados

1. Associe uma fonte de dados. Após a associação, selecione as tabelas de dados, clique em >> para adicioná-las e confirme a seleção.

2. Após a confirmação, a página de mapeamento de campos será exibida. Selecione Add Data. O OpenSearch mapeia automaticamente os campos source para os campos da aplicação que têm o mesmo nome. Mapeie manualmente os campos com nomes diferentes.

3. Na página de mapeamento de campos, você também pode configure plug-ins de fonte de dados. Para mais informações, consulte data source plug-in documentation.

   Nota

   Para sincronização de dados em tempo real, consulte DTS real-time synchronization.

4. Conclua a criação.

Etapa 3: Teste a busca

Após o upload dos dados, teste a funcionalidade de busca. O console do OpenSearch oferece uma página Search test integrada. Configure cláusulas de consulta e parâmetros para execute testes conforme suas necessidades (para mais detalhes, consulte API overview e SDK introduction). Esta seção utiliza a página Search Test como exemplo. Para testar sua configuração de busca, clique em ícone + ao lado de uma cláusula ou parâmetro, selecione um item na lista suspensa, insira o conteúdo correspondente e clique em Search.

Uso

1. No painel de navegação à esquerda, escolha Feature Extensions > Search test. Insira uma consulta na cláusula de consulta obrigatória.

   Selecione Online application. Na cláusula config, defina start:0,hit:10,format:fulljson e clique em Search para visualize os resultados.

2. Adicione mais cláusulas e parâmetros conforme necessário.

   Clique em ícone + para adicionar uma cláusula. As opções disponíveis são: cláusula filter, cláusula sort, cláusula distinct, cláusula aggregate, cláusula kvpairs e cláusula config.

   Clique em ícone + ao lado de Parameters para adicionar um parâmetro. Os parâmetros disponíveis incluem: campos de exibição (fetch_fields), análise de consulta (qp), first_rank_name (expressão de ordenação grosseira), second_rank_name (expressão de ordenação refinada), tipo de plug-in de ordenação refinada (second_rank_type), configuração de resumo (summary), predição de categoria (category_prediction), consulta original (raw_query), política de re-busca (re_search), informações de negócio (biz), ID da requisição de busca (from_request_id), ID do usuário (user_id), teste A/B (abtest), desabilitar (disable) e parâmetros personalizados (custom).

Informações adicionais

Cláusulas

Cláusula query: Consulte a documentação de query clause.

Cláusula filter: Consulte a documentação de filter clause.

Cláusula sort: Consulte a documentação de sort clause.

Cláusula distinct: Consulte a documentação de distinct clause.

Cláusula aggregate: Consulte a documentação de aggregate clause.

Cláusula kvpairs: Consulte a documentação de kvpairs clause.

Cláusula config: Consulte a documentação de config clause.

Parâmetros

Campos de exibição (fetch_fields): Especifica os campos a retornar nos resultados. Separe múltiplos nomes de campos com ponto e vírgula (;).

Análise de consulta (qp): Especifica o nome da regra de análise de consulta.

first_rank_name (expressão de ordenação grosseira): Especifica o nome da expressão de ordenação grosseira.

second_rank_name (expressão de ordenação refinada): Especifica o nome da expressão de ordenação refinada.

Configuração de resumo (summary): Define o resumo dos resultados de busca. Para mais informações, consulte Search result summary.

Predição de categoria e consulta original: Especifique o nome da predição de categoria e os termos da consulta.

Política de re-busca (re_search): Define a política de re-busca. Para mais informações, consulte Search processing.

Para informações de negócio (biz) e o ID do usuário, consulte Search processing.

Teste A/B: Especifica o nome do teste A/B.

Desabilitar (disable): Desabilita um recurso específico. Por exemplo, disable=qp.

Para detalhes sobre recursos avançados, consulte a documentação correspondente do product.