Todos os produtos
Search
Central de documentação

OpenSearch:Fonte de dados de API

Última atualização: Oct 29, 2026

Este tópico descreve como adicionar uma tabela que usa uma fonte de dados de API. Para começar, crie a fonte de dados.

Adicionar uma fonte de dados de API

  1. Na página Instance Details > Table Management, clique em Add Table.

  2. Insira as informações básicas da tabela e clique em Next:

    As informações básicas incluem três configurações: Table name, Number of Shards e Data Update Resources. Depois de configurar essas opções, clique em Next.

    Detalhes da configuração:

  • Table name: Se necessário, modifique este nome.

  • Number of Shards: Ao configurar a tabela, defina o número de shards e certifique-se de que todas as tabelas de índice tenham o mesmo número de shards. Como alternativa, uma tabela de índice pode ter um único shard, enquanto as outras têm o mesmo número de shards. O número de shards de uma tabela deve ser um número inteiro positivo, não maior que 256. Recomendamos que esse número não exceda três vezes o número de nós de dados na sua instância.

  • Data Update Resources: Os recursos usados para atualização de dados. Se necessário, atualize esses recursos. Por padrão, cada índice inclui dois recursos de atualização gratuitos (4 núcleos e 8 GB cada um). O uso de recursos além da cota gratuita gera cobranças. Para mais detalhes, consulte Billing overview of OpenSearch Retrieval Engine Edition.

  1. Para sincronização de dados, configure a fonte de dados e clique em Next:

    Na seção Full data source, selecione API e clique em Next.

    Detalhes dos parâmetros:

  • Tipo de fonte de dados: Selecione uma fonte de dados de push de API para enviar dados à instância por meio de APIs.

  1. Configure os campos e os índices no esquema do índice e clique em Next:

    Na seção Field Settings, adicione id (INT64, chave primária, com atributo e exibição de resultados de pesquisa ativados, e compressão de dados definida como equal) e namespace (STRING, com atributo e exibição de resultados de pesquisa ativados, e compressão de dados definida como uniq). Na seção Index Settings, configure id (PRIMARYKEY128, contendo id) e test_name (STRING, contendo namespace).

  2. Confirme a criação. Após a confirmação, o sistema cria automaticamente a tabela configurada:

    Uma mensagem do sistema é exibida: Após a confirmação, a construção do índice começa automaticamente com base nos recursos simultâneos selecionados. Após a construção do índice, ele é ativado automaticamente na instância atual. Clique em Confirm Creation para concluir.

  3. Expanda o processo de alteração Deploy New Data Source e visualize o status de cada nó, incluindo Parameter check, Create configuration, Create message queue, Create scan plan, Create index building plan, Create cleanup plan e Modify table status. Os detalhes da alteração exibem o nome do cluster e o nome da fonte de dados correspondentes.

  4. Quando a tabela estiver em uso, teste consultas na página Query Test.

Notas de uso

  • Ao reconstruir o índice de uma fonte de dados de API, o sistema limpa todos os dados enviados anteriormente e inicia a sincronização de dados em tempo real a partir de um timestamp especificado. Portanto, tenha cuidado ao realizar uma importação completa de dados.

  • Uma fonte de dados de API só pode ser excluída quando estiver no status Unused.