

# Conectar ao Azure SQL no AWS Glue Studio
<a name="connecting-to-data-azuresql"></a>

 O AWS Glue oferece suporte integrado ao Azure SQL. O AWS Glue Studio fornece uma interface visual para conectar ao Azure SQL, criar trabalhos de integração de dados e executá-los no runtime Spark do AWS Glue Studio sem servidor. 

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

# Criar uma conexão do Azure SQL
<a name="creating-azuresql-connection"></a>

Para se conectar ao Azure SQL via AWS Glue, será necessário criar e armazenar sua credenciais do Azure SQL em um segredo do AWS Secrets Manager e, em seguida, associar esse segredo a uma conexão do Azure SQL AWS Glue.

**Para configurar uma conexão com o Azure SQL:**

1. No AWS Secrets Manager, crie um segredo usando suas credenciais do Azure SQL. 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 `user` com o valor *azuresqlUsername*.
   + Ao selecionar **Pares chave/valor**, crie um par para a chave `password` com o valor *azuresqlPassword*.

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**, selecione Azure SQL.
   + Ao fornecer o **URL do Azure SQL**, forneça um URL de endpoint do JDBC.

      Essa lista deve estar no seguinte formato: `jdbc:sqlserver://databaseServerName:databasePort;databaseName=azuresqlDBname;`.

     O AWS Glue requer as seguintes propriedades de URL: 
     + `databaseName`: um banco de dados padrão no Azure SQL ao qual se conectar.

     Para obter mais informações sobre URLs de JDBC para instâncias gerenciadas Azure SQL, consulte a [Documentação da Microsoft](https://learn.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?view=azuresqldb-mi-current).
   + Ao selecionar um **Segredo da AWS**, forneça o *secretName*.

# Criar um nó de origem do Azure SQL
<a name="creating-azuresql-source-node"></a>

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

  Uma tabela do Azure SQL é identificada por seu banco de dados, esquema e nome da tabela. É necessário fornecer o nome do banco de dados e o nome da tabela ao se conectar ao Azure SQL. Você também deverá fornecer o esquema se ele não for o padrão, "public". O banco de dados é fornecido por meio de uma propriedade de URL em *connectionName*, esquema e nome da tabela via `dbtable`.

## Adicionar uma fonte de dados do Azure SQL
<a name="creating-azuresql-source-node-add"></a>

**Para adicionar um nó de **Fonte de dados – Azure SQL**:**

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

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

1.  Escolha uma opção de **Fonte do Azure SQL**: 
   +  **Escolher uma única tabela**: acesse todos os dados de uma única tabela. 
   +  **Inserir consulta personalizada**: acesse um conjunto de dados de várias tabelas com base em sua consulta personalizada. 

1.  Se você escolheu uma única tabela, insira *tableName*. 

    Se você escolheu **Inserir consulta personalizada**, insira uma consulta TransactSQL SELECT. 

1.  Em **Propriedades personalizadas do Azure SQL**, insira parâmetros e valores conforme necessário. 

# Criar um nó de destino do Azure SQL
<a name="creating-azuresql-target-node"></a>

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

  Uma tabela do Azure SQL é identificada por seu banco de dados, esquema e nome da tabela. É necessário fornecer o nome do banco de dados e o nome da tabela ao se conectar ao Azure SQL. Você também deverá fornecer o esquema se ele não for o padrão, "public". O banco de dados é fornecido por meio de uma propriedade de URL em *connectionName*, esquema e nome da tabela via `dbtable`.

## Adicionar um destino de dados do Azure SQL
<a name="creating-azuresql-target-node-add"></a>

**Para adicionar um nó de **Destino de dados – Azure SQL**:**

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

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

1. Configure o **nome da tabela** fornecendo o *tableName*.

1.  Em **Propriedades personalizadas do Azure SQL**, insira parâmetros e valores conforme necessário. 

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

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

Consulte [Conexões do Azure SQL](aws-glue-programming-etl-connect-azuresql-home.md). 