# Conectar ao OpenSearch Service no AWS Glue Studio
<a name="connecting-to-data-opensearch"></a>

 O AWS Glue oferece suporte integrado ao Amazon OpenSearch Service. O AWS Glue Studio fornece uma interface visual para conectar ao Amazon OpenSearch Service, criar trabalhos de integração de dados e executá-los no runtime Spark do AWS Glue Studio sem servidor. Esse recurso não é compatível com o OpenSearch Service com tecnologia sem servidor. 

 O AWS Glue Studio cria uma conexão unificada para o Amazon OpenSearch Service. Para obter mais informações, consulte [Considerações](using-connectors-unified-connections.md#using-connectors-unified-connections-considerations). 

**Topics**
+ [Criar uma conexão com o OpenSearch Service](creating-opensearch-connection.md)
+ [Criar um nó de origem do OpenSearch Service](creating-opensearch-source-node.md)
+ [Criar um nó de destino do OpenSearch Service](creating-opensearch-target-node.md)
+ [Opções avançadas](#creating-opensearch-connection-advanced-options)

# Criar uma conexão com o OpenSearch Service
<a name="creating-opensearch-connection"></a>

**Pré-requisitos**:
+ Identifique o endpoint do domínio, *aosEndpoint* e porta, *aosPort* do qual gostaria de ler, ou crie o recurso seguindo as instruções na documentação do Amazon OpenSearch Service. Para obter mais informações sobre a criação de domínios, consulte [Criar e gerenciar domínios do Amazon OpenSearch Service](https://docs.aws.amazon.com//opensearch-service/latest/developerguide/createupdatedomains.html) na documentação do Amazon OpenSearch Service.

  Um endpoint de domínio do Amazon OpenSearch Service terá o seguinte formato padrão, https://search-*domainName*-*unstructuredIdContent*.*region*.es.amazonaws.com. Para obter mais informações sobre a identificação do endpoint do domínio, consulte [Criar e gerenciar domínios do Amazon OpenSearch Service](https://docs.aws.amazon.com//opensearch-service/latest/developerguide/createupdatedomains.html) na documentação do Amazon OpenSearch Service. 

  Identifique ou gere credenciais de autenticação básica HTTP, *aosUser* e *aosPassword* para seu domínio.

**Para configurar uma conexão com o OpenSearch Service:**

1. No AWS Secrets Manager, crie um segredo usando suas credenciais do OpenSearch Service. Para criar um segredo no Secrets Manager, siga o tutorial disponível em [Criar uma AWS Secrets Manager segredo ](https://docs.aws.amazon.com//secretsmanager/latest/userguide/create_secret.html) na documentação do AWS Secrets Manager. Depois de criar o segredo, guarde o nome secreto, *SecretName*, para a próxima etapa. 
   + Ao selecionar **Pares chave/valor**, crie um par para a chave `USERNAME` com o valor *aosUser*.
   + Ao selecionar **Pares chave/valor**, crie um par para a chave `PASSWORD` com o valor *aosPassword*.

1. No console do AWS Glue, crie uma conexão seguindo as etapas em [Adicionar uma conexão do AWS Glue](console-connections.md). Depois de criar a conexão, guarde o nome da conexão, *connectionName*, para uso futuro em AWS Glue. 
   + Ao selecionar um **Tipo de conexão**, escolha OpenSearch Service.
   + Ao selecionar um endpoint de domínio, forneça *aosEndpoint*.
   + Ao selecionar uma porta, forneça *aosPort*.
   + Ao selecionar um **Segredo da AWS**, forneça o *secretName*.

# Criar um nó de origem do OpenSearch Service
<a name="creating-opensearch-source-node"></a>

## Pré-requisitos necessários
<a name="creating-opensearch-source-node-prerequisites"></a>
+ Uma conexão do AWS Glue OpenSearch Service, configurada com um segredo do AWS Secrets Manager, conforme descrito na seção anterior, [Criar uma conexão com o OpenSearch Service](creating-opensearch-connection.md).
+ Permissões apropriadas em seu trabalho para ler o segredo usado pela conexão.
+ Um índice do OpenSearch Service do qual você gostaria de ler, *aosIndex*.

## Adicionar uma fonte de dados do OpenSearch Service
<a name="creating-opensearch-source-node-add"></a>

**Para adicionar um nó de **Fonte de dados – OpenSearch Service**:**

1.  Escolha a conexão para sua fonte de dados do OpenSearch Service. Como você o criou, ele deve estar disponível no menu suspenso. Se precisar criar uma conexão, escolha **Criar conexão com o OpenSearch Service**. Para mais informações, consulte a seção [Criar uma conexão com o OpenSearch Service](creating-opensearch-connection.md) anterior. 

    Depois de escolher uma conexão, você pode visualizar as propriedades da conexão clicando em **Exibir propriedades**. 

1. Forneça o **Índice** que você gostaria de ler.

1. Opcionalmente, forneça **Consulta**, uma consulta do OpenSearch para fornecer resultados mais específicos. Para obter mais informações sobre como escrever consultas do OpenSearch, consulte [Ler dos índices do OpenSearch Service](aws-glue-programming-etl-connect-opensearch-home.md#aws-glue-programming-etl-connect-opensearch-read).

1.  Em **Propriedades personalizadas do OpenSearch Service**, insira parâmetros e valores conforme o necessário. 

# Criar um nó de destino do OpenSearch Service
<a name="creating-opensearch-target-node"></a>

## Pré-requisitos necessários
<a name="creating-opensearch-target-node-prerequisites"></a>
+ Uma conexão do AWS Glue OpenSearch Service, configurada com um segredo do AWS Secrets Manager, conforme descrito na seção anterior, [Criar uma conexão com o OpenSearch Service](creating-opensearch-connection.md).
+ Permissões apropriadas em seu trabalho para ler o segredo usado pela conexão.
+ Um índice do OpenSearch Service em que você gostaria de escrever, *aosIndex*.

## Adicionar um destino de dados do OpenSearch Service
<a name="creating-opensearch-target-node-add"></a>

**Para adicionar um nó de **Destino de dados – OpenSearch Service**:**

1.  Escolha a conexão para sua fonte de dados do OpenSearch Service. Como você o criou, ele deve estar disponível no menu suspenso. Se precisar criar uma conexão, escolha **Criar conexão com o OpenSearch Service**. Para mais informações, consulte a seção [Criar uma conexão com o OpenSearch Service](creating-opensearch-connection.md) anterior. 

    Depois de escolher uma conexão, você pode visualizar as propriedades da conexão clicando em **Exibir propriedades**. 

1. Forneça o **Índice** que você gostaria de ler.

1.  Em **Propriedades personalizadas do OpenSearch Service**, insira parâmetros e valores conforme o necessário. 

## Opções avançadas
<a name="creating-opensearch-connection-advanced-options"></a>

É possível fornecer opções avançadas ao criar um nó do OpenSearch Service. Essas opções são as mesmas disponíveis ao programar AWS Glue para scripts do Spark.

Consulte [Conexões do OpenSearch Service](aws-glue-programming-etl-connect-opensearch-home.md).