

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Connessioni Azure SQL
<a name="aws-glue-programming-etl-connect-azuresql-home"></a>

Puoi usare AWS Glue for Spark per leggere e scrivere su tabelle su istanze gestite SQL di Azure in AWS Glue 4.0 e versioni successive. È possibile definire cosa leggere da Azure SQL con una query SQL. Ti connetti ad Azure SQL usando le credenziali utente e password archiviate tramite una connessione Glue. AWS Secrets Manager AWS 

Per altre informazioni su Azure SQL, consulta [la documentazione di Azure SQL](https://azure.microsoft.com/en-us/products/azure-sql).

## Configurazione delle connessioni Azure SQL
<a name="aws-glue-programming-etl-connect-azuresql-configure"></a>

Per connetterti ad Azure SQL da AWS Glue, dovrai creare e archiviare le tue credenziali SQL di Azure in un AWS Secrets Manager segreto, quindi associare quel segreto a una connessione Azure SQL Glue. AWS 

**Per configurare una connessione ad Azure SQL:**

1. In AWS Secrets Manager, crea un segreto usando le tue credenziali SQL di Azure. Per creare un segreto in Secrets Manager, segui il tutorial disponibile in [ Crea un AWS Secrets Manager segreto ](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html) nella AWS Secrets Manager documentazione. Dopo aver creato il segreto, mantieni il nome del segreto, {{secretName}} per il passaggio successivo. 
   + Quando selezioni ** Key/value le coppie**, crea una coppia per la chiave `user` con il valore{{azuresqlUsername}}.
   + Quando selezionate ** Key/value le coppie**, create una coppia per la chiave `password` con il valore{{azuresqlPassword}}.

1. Nella console AWS Glue, create una connessione seguendo i passaggi indicati in[Aggiungere una AWS Glue connessione](console-connections.md). Dopo aver creato la connessione, mantieni il nome della connessione{{connectionName}}, per un uso futuro in AWS Glue. 
   + In **Tipo di connessione**, seleziona Azure SQL.
   + Quando fornisci l'**URL SQL di Azure**, fornisci un URL di endpoint JDBC.

      L'elenco deve essere nel seguente formato: `jdbc:sqlserver://{{databaseServerName}}:{{databasePort}};databaseName={{azuresqlDBname}};`.

     AWS Glue richiede le seguenti proprietà URL: 
     + `databaseName`: un database predefinito in Azure SQL a cui connettersi.

     Per altre informazioni sugli URL JDBC per le istanze gestite di Azure SQL, consulta la [documentazione di Microsoft.](https://learn.microsoft.com/en-us/sql/connect/jdbc/building-the-connection-url?view=azuresqldb-mi-current)
   + Quando selezioni un **AWS segreto**, fornisci{{secretName}}.

Dopo aver creato una connessione AWS Glue Azure SQL, dovrai eseguire i seguenti passaggi prima di eseguire il processo AWS Glue:
+ Concedi al ruolo IAM associato al tuo lavoro AWS Glue il permesso di lettura{{secretName}}.
+ Nella configurazione del job AWS Glue, {{connectionName}} forniscilo come connessione di rete ** aggiuntiva**.

## Lettura da tabelle SQL di Azure
<a name="aws-glue-programming-etl-connect-azuresql-read"></a>

**Prerequisiti:** 
+ Una tabella Azure SQL da cui si desidera leggere. Avrai bisogno delle informazioni di identificazione per la tabella {{databaseName}} e{{tableIdentifier}}.

  Una tabella SQL di Azure è identificata dal database, dallo schema e dal nome. È necessario fornire il nome del database e della tabella durante la connessione ad Azure SQL. È inoltre necessario fornire lo schema se diverso da quello predefinito, "pubblico". Il database viene fornito tramite una proprietà URL in{{connectionName}}, schema e nome della tabella tramite`dbtable`.
+ Una connessione SQL di AWS Glue Azure configurata per fornire informazioni di autenticazione. Completa i passaggi della procedura precedente, *Per configurare una connessione ad Azure SQL* per configurare le informazioni di autenticazione. Avrai bisogno del nome della connessione AWS Glue,. {{connectionName}} 

Ad esempio: 

```
azuresql_read_table = glueContext.create_dynamic_frame.from_options(
    connection_type="azuresql",
    connection_options={
        "connectionName": "{{connectionName}}",
        "dbtable": "{{tableIdentifier}}"
    }
)
```

Puoi anche fornire una query SELECT SQL, per filtrare i risultati restituiti al tuo DynamicFrame. Sarà necessario configurare `query`.

Ad esempio:

```
azuresql_read_query = glueContext.create_dynamic_frame.from_options(
    connection_type="azuresql",
    connection_options={
        "connectionName": "{{connectionName}}",
        "query": "{{query}}"
    }
)
```

## Scrittura su tabelle SQL di Azure
<a name="aws-glue-programming-etl-connect-azuresql-write"></a>

Questo esempio scrive informazioni da un SQL esistente DynamicFrame {{dynamicFrame}} in Azure SQL. Se la tabella contiene già informazioni, AWS Glue aggiungerà i dati del tuo. DynamicFrame

**Prerequisiti:** 
+ Una tabella di Azure SQL su cui scrivere. Avrai bisogno delle informazioni di identificazione per la tabella, {{databaseName}} e{{tableIdentifier}}.

  Una tabella SQL di Azure è identificata dal database, dallo schema e dal nome. È necessario fornire il nome del database e della tabella durante la connessione ad Azure SQL. È inoltre necessario fornire lo schema se diverso da quello predefinito, "pubblico". Il database viene fornito tramite una proprietà URL in{{connectionName}}, schema e nome della tabella tramite`dbtable`.
+ Informazioni di autenticazione SQL di Azure. Completa i passaggi della procedura precedente, *Per configurare una connessione ad Azure SQL* per configurare le informazioni di autenticazione. Avrai bisogno del nome della connessione AWS Glue,{{connectionName}}. 

Ad esempio: 

```
azuresql_write = glueContext.write_dynamic_frame.from_options(
    connection_type="azuresql",
    connection_options={
        "connectionName": "{{connectionName}}",
        "dbtable": "{{tableIdentifier}}"
    }
)
```

## Indicazioni di riferimento alle opzioni di connessione ad Azure SQL
<a name="aws-glue-programming-etl-connect-azuresql-reference"></a>
+ `connectionName`: obbligatorio. Usato per Read/Write. Il nome di una connessione SQL di Azure AWS Glue configurata per fornire informazioni di autenticazione al metodo di connessione.
+ `databaseName`— Usato per. Read/Write Valori validi: nomi di database di Azure SQL. Il nome del database in Azure SQL a cui connettersi.
+ `dbtable` — Richiesto per la scrittura, richiesto per la lettura a meno che non `query` sia fornito. Usato per Read/Write. Valori validi: nomi delle tabelle SQL di Azure o combinazioni di schema/table nomi separate da punti. Utilizzato per specificare la tabella e lo schema che identificano la tabella a cui connettersi. Lo schema predefinito è "pubblico". Se la tabella rientra in uno schema non predefinito, fornisci queste informazioni nel modulo `{{schemaName}}.{{tableName}}`.
+ `query`: utilizzato per la lettura. Una query Transact-SQL SELECT che definisce cosa deve essere recuperato durante la lettura da Azure SQL. Per ulteriori informazioni, consulta la [documentazione di Microsoft](https://learn.microsoft.com/en-us/sql/t-sql/queries/select-transact-sql?view=azuresqldb-mi-current).