Todos os produtos
Search

Este produto

    OpenSearch:Guia de início rápido

    Central de documentação

    OpenSearch:Guia de início rápido

    Última atualização: Oct 19, 2026

    Pré-requisitos

    1. Você já registrou uma conta Alibaba Cloud e concluiu a verificação de nome real.

    2. Após criar uma conta Alibaba Cloud e fazer login no console, o sistema solicitará a criação de um par de AccessKey para que você possa continuar.

    • A criação e o uso de aplicativos dependem dos parâmetros de AccessKey. Os parâmetros de AccessKey da conta Alibaba Cloud não podem estar vazios.

    • Depois de configurar os parâmetros de AccessKey para a conta Alibaba Cloud, também é possível criar pares de AccessKey para usuários RAM e acessar recursos como usuário RAM. Para conceder as permissões de acesso necessárias aos usuários RAM, consulte RAM authorization.

    1. É necessário ter um ambiente VPC. Para mais informações, consulte What is VPC.

    Nota:

    Para gerenciar instâncias do OpenSearch Retrieval Engine Edition com um usuário RAM, utilize sua conta Alibaba Cloud para conceder as permissões AliyunSearchEngineFullAccess e AliyunSearchEngineReadOnlyAccess a esse usuário.

    Adquirir uma instância

    Para obter informações sobre como adquirir uma instância, consulte Purchase an OpenSearch Retrieval Engine Edition instance

    Configurar o cluster

    Nota:

    Na página de detalhes de uma instância recém-adquirida, o status da instância aparece como "Pending Configuration". Um cluster vazio é implantado automaticamente, com quantidade e especificações de nós Query Result Searcher (QRS) e nós de dados correspondentes à sua compra.

    1. Selecione a instância desejada e clique em Configure.

    2. Insira o nome da tabela, selecione o número de shards e a quantidade de recursos de atualização de dados conforme necessário e clique em Next.

      Nota

      Name: O nome pode conter letras, dígitos e sublinhados (_), com até 25 caracteres.

      Number of Shards: Insira um número inteiro positivo que não exceda 256. Os shards aceleram a construção completa do índice e melhoram o desempenho de consultas individuais.

      Number of Data Update Resources: Quantidade de recursos dedicados a atualizações de dados em tempo real. Ajustar esses recursos aumenta a concorrência no consumo de dados em tempo real, elevando o TPS.

    3. Configure a fonte de dados. As fontes suportadas são "MaxCompute + API data source", "OSS + API data source", "API data source" e Data Lake Formation (DLF). Este tópico utiliza uma fonte de dados MaxCompute como exemplo. Após definir os parâmetros, escolha se deseja ativar "Automatic Index Rebuilding" conforme sua necessidade. Quando a verificação for bem-sucedida, clique em Next.

    Para configurar uma fonte de dados MaxCompute, especifique os seguintes parâmetros: AccessKey e AccessKey Secret, Project (deve começar com uma letra, conter apenas letras, dígitos e sublinhados, e ter entre 3 e 28 caracteres), Table (deve começar com uma letra, conter apenas letras, dígitos e sublinhados, e ter entre 1 e 128 caracteres) e Partition (separe partições multinível com vírgulas). Ao concluir as definições, clique em Verify para validar a fonte de dados. Somente após essa validação será possível clicar em Next.

    1. Selecione a chave primária, os campos de atributo e os campos a serem exibidos nos resultados de busca. Defina se haverá compressão de dados e escolha o método de análise para os campos correspondentes.

    Compressão de atributos e conteúdo de campo:

    • A compressão de campos de atributo é opcional. Por padrão, esses campos não são compactados. Selecionar file_compressor ativa a compressão.

    • Também é possível optar por comprimir o conteúdo dos campos. Por padrão, não há compressão. Campos multivalorados e STRING utilizam uniq, enquanto campos numéricos de valor único usam equal.

    Nota

    • Ao ativar a compressão de atributos, recomenda-se acessar Cluster Management > Node Status > Table Loading Policy para editar o método de carregamento do índice e reduzir o impacto no desempenho.

    • Os campos configurados com método de análise devem ser do tipo TEXT.

    • É permitido copiar campos. O conteúdo do novo campo copiado (campo DUP) permanece idêntico ao original. Caso haja divergência durante o push, o conteúdo original sobrescreverá o campo copiado. Se desejar conteúdos diferentes, remova manualmente a cópia das configurações avançadas do campo DUP.

    • Quando um campo estiver ausente ou vazio nos dados, o sistema preencherá automaticamente um valor padrão: 0 para tipos numéricos e string vazia para o tipo STRING. Há suporte para valores padrão personalizados.

    1. Configure índices para os campos que precisam ser recuperados por índice. Após concluir a configuração, clique em Next.

    2. Configuração de índices: Na página de definições de índice, defina Index Name, Index Type (como TEXT ou STRING), Included Fields e o método de Data Compression. Clique em View/Modify para ajustar configurações avançadas ou em + para adicionar uma linha de índice. Ao finalizar, clique em Next.

    3. Clique em Confirm Creation e aguarde a conclusão da compilação da versão.

    Após confirmar que as informações estão corretas, clique em Confirm Creation. O sistema construirá os índices automaticamente com base nos recursos concorrentes selecionados. Quando a compilação terminar, os índices serão ativados automaticamente na instância atual.

    Visualizar o progresso de reconstrução do índice

    No painel de navegação à esquerda, clique em Change History e selecione Last 3 Days para acompanhar o progresso detalhado da compilação.

    Teste de consulta

    Realize testes simples de busca em Extended Features > Query Test. O OpenSearch Retrieval Engine Edition suporta três métodos de consulta: HA query, SQL query e RESTful API.

    Ao escolher HA query como método, insira a instrução de consulta na caixa query (por exemplo, id:'1'; para o formato, consulte a dica daogou:part_ids=0|2). Em seguida, defina cluster (exemplo: general) e config (exemplo: start:0,hit:10,format:json). Após enviar a consulta, a parte inferior da página exibirá a URL da requisição, o número de correspondências, o tempo consumido e os valores retornados para cada campo.

    Observações de uso

    Importante

    • Atualmente, há suporte apenas para o modelo de pagamento conforme o uso.

    • O nome de usuário e a senha definidos durante a aquisição da instância podem ser alterados na página de detalhes da instância.

    • O nome do cluster é atribuído pelo sistema no momento da compra e, por enquanto, não pode ser modificado.

    • A reconstrução de índices é cobrada com base nos recursos consumidos em cada execução. Para mais detalhes, consulte Billing of OpenSearch Retrieval Engine Edition on the international site.