Gestore connessioni OLEDB

Si applica a:SQL Server SSIS Integration Runtime in Azure Data Factory

Una gestione connessione OLEDB consente la connessione di un pacchetto a un'origine dati tramite un provider OLEDB. Una gestione connessione OLEDB che si connette a SQL Server, ad esempio, può usare il provider Microsoft OLEDB per SQL Server.

Numerosi componenti del flusso di dati e attività di SQL Server Integration Services usano una gestione connessione OLEDB. Ad esempio, l'origine OLE DB e la destinazione OLE DB usano questo gestore di connessione per estrarre e caricare i dati. L'attività Esegui SQL può usare la gestione connessione per connettersi a un database di SQL Server ed eseguire query.

È anche possibile usare la gestione connessioni OLE DB per accedere alle origini dati OLE DB in attività personalizzate scritte in codice non gestito che utilizza un linguaggio come C++.

Quando si aggiunge una gestione connessione OLE DB a un pacchetto, Integration Services crea una gestione connessione che in fase di esecuzione viene risolta in una connessione OLEDB, imposta le proprietà di tale gestione connessione e quindi la aggiunge alla raccolta Connessioni del pacchetto.

La proprietà ConnectionManagerType della gestione connessione viene impostata su OLEDB.

Configurare la gestione connessione OLEDB nel modo seguente:

• Specificare una stringa di connessione configurata in modo da soddisfare i requisiti del provider selezionato.

• Se richiesto dal provider, includere il nome dell'origine dei dati a cui connettersi.

• Specificare le credenziali di sicurezza come previsto dal provider selezionato.

• Indicare se la connessione creata dalla gestione connessione deve essere mantenuta in fase di esecuzione.

Registrare le chiamate e risolvere i problemi delle connessioni

È possibile registrare le chiamate eseguite dalla gestione connessione OLEDB a provider di dati esterni. È quindi possibile risolvere i problemi relativi alle connessioni stabilite dal gestore di connessione OLE DB con origini dati esterne. Per registrare le chiamate effettuate dal gestore connessioni OLEDB ai provider di dati esterni, abilitare la registrazione del pacchetto e selezionare l'evento Diagnostic a livello di pacchetto. Per altre informazioni, vedere Risoluzione dei problemi relativi agli strumenti per l'esecuzione del pacchetto.

Configurare il gestore connessioni OLE DB

È possibile impostare le proprietà tramite Progettazione SSIS o a livello di codice.

Configura gestione connessione OLEDB

Usare la finestra di dialogo Configura gestione connessione OLEDB per aggiungere una connessione a un'origine dati. Questa connessione può essere nuova o una copia di una connessione esistente.

Per altre informazioni sulla gestione connessione OLEDB, vedere Gestione connessione OLEDB.

Opzioni

Connessioni dati
Consente di selezionare una connessione dati OLEDB esistente nell'elenco.

Proprietà connessione dati
Consente di visualizzare proprietà e valori per la connessione dati OLEDB selezionata.

Nuovo
Consente di creare una connessione dati OLEDB tramite la finestra di dialogo Gestione connessione.

Elimina
Selezionare una connessione dati e quindi eliminarla selezionando Elimina.

Identità gestite per l'autenticazione delle risorse di Azure

Quando si eseguono pacchetti SSIS in Azure-SSIS Integration Runtime (IR) in Azure Data Factory (ADF), è possibile usare l'autenticazione di Microsoft Entra con identità gestite assegnate dall'utente o dal sistema per Azure Data Factory per accedere al database SQL di Azure o all'Istanza gestita di SQL. Azure-SSIS IR può accedere e copiare dati da o nel database usando questa identità gestita.

Per usare l'autenticazione di Microsoft Entra con l'identità gestita per Azure Data Factory per accedere al server di database SQL di Azure, seguire questa procedura:

1. Configurare un amministratore Microsoft Entra per il tuo server logico nel portale di Azure, se non l'hai già fatto. L'amministratore di Microsoft Entra può essere un utente o un gruppo di Microsoft Entra. Se si assegna un gruppo come amministratore, è possibile aggiungere l'identità gestita di Azure Data Factory al gruppo e ignorare i passaggi 2 e 3. L'amministratore ha accesso completo al server logico per il database SQL di Azure.

2. Creare un utente di database contenuto per l'identità gestita di ADF. Usare SQL Server Management Studio (SSMS) per connettersi al database con un utente Microsoft Entra con almeno l'autorizzazione ALTER ANYUSER. Eseguire l'istruzione T-SQL seguente:

   CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;
   

   Se si usa l'identità gestita assegnata dal sistema per Azure Data Factory, il nome dell'identità gestita deve essere il nome relativo ad Azure Data Factory. Se si usa un'identità gestita assegnata dall'utente per Azure Data Factory, il nome dell'identità gestita deve essere il nome dell'identità gestita assegnata dall'utente specificata.

3. Concedere all'identità gestita per Azure Data Factory le autorizzazioni necessarie, come si fa normalmente per gli utenti SQL. Per i ruoli appropriati, vedere Ruoli a livello di database. Eseguire l'istruzione T-SQL seguente. Per altre opzioni, vedere questo articolo.

   EXEC sp_addrolemember [role name], [your managed identity name];
   

Per usare l'autenticazione di Microsoft Entra con l'identità gestita per ADF per accedere all'Istanza gestita di Azure SQL, segui questi passaggi:

1. Configurare un amministratore Microsoft Entra per Istanza gestita di SQL di Azure nel portale di Azure, se non l'hai già fatto. L'amministratore di Microsoft Entra può essere un utente o un gruppo di Microsoft Entra. Se si assegna un gruppo come amministratore, è possibile aggiungere l'identità gestita di Azure Data Factory al gruppo e ignorare i passaggi 2 e 3. L'amministratore ha accesso completo all'Istanza gestita di SQL di Azure.

2. Creare un account di accesso assegnato all'identità gestita per Azure Data Factory. In SSMS, connettiti all'istanza gestita di SQL di Azure usando un account di SQL Server che sia sysadmin. Nel database master eseguire l'istruzione T-SQL seguente:

   CREATE LOGIN [your managed identity name] FROM EXTERNAL PROVIDER;
   

   Se si utilizza l'identità gestita dal sistema per l'ADF, il nome dell'identità gestita deve coincidere con il nome dell'ADF. Se si usa un'identità gestita assegnata dall'utente per Azure Data Factory, il nome dell'identità gestita deve essere il nome dell'identità gestita assegnata dall'utente specificata.

3. Creare un utente di database indipendente per rappresentare l'identità gestita per Azure Data Factory. Connettersi al database da cui o in cui si vuole copiare i dati tramite SSMS ed eseguire l'istruzione T-SQL seguente:

   CREATE USER [your managed identity name] FROM EXTERNAL PROVIDER;
   

4. Concedere all'identità gestita per Azure Data Factory le autorizzazioni necessarie, come si fa normalmente per gli utenti SQL. Eseguire l'istruzione T-SQL seguente. Per altre opzioni, vedere questo articolo.

   ALTER ROLE [role name e.g., db_owner] ADD MEMBER [your managed identity name];
   

È quindi possibile configurare il provider OLEDB nella gestione connessione OLEDB. Sono disponibili le opzioni seguenti:

• Configurare in fase di progettazione. In SSIS Designer, fare doppio clic sul connection manager OLE DB per aprire la finestra Gestione connessioni. Nell'elenco a discesa Provider selezionare Microsoft OLEDB Driver per SQL Server.

  Nota

  Altri provider nell'elenco a discesa potrebbero non supportare l'autenticazione Microsoft Entra con l'identità gestita di Azure Data Factory.

• Configurare in fase di esecuzione. Quando si esegue il pacchetto tramite SSMS o l'attività Execute SSIS Package nella pipeline ADF, individuare la proprietà ConnectionString nel gestore connessioni OLEDB. Aggiornare la proprietà di connessione Provider impostandola su MSOLEDBSQL, ovvero Microsoft OLEDB Driver per SQL Server.

  Data Source=serverName;Initial Catalog=databaseName;Provider=MSOLEDBSQL;...
  

È ora possibile configurare l'autenticazione di Microsoft Entra con l'identità gestita di Azure Data Factory nella gestione connessione OLEDB. Sono disponibili le opzioni seguenti:

• Configurare in fase di progettazione. In SSIS Designer, fare clic con il pulsante destro sul gestore connessioni OLEDB e selezionare Proprietà. Aggiornare la proprietà ConnectUsingManagedIdentity impostandola su True.

  Nota

  Attualmente, la proprietà di gestione connessione ConnectUsingManagedIdentity non ha effetto quando si esegue il pacchetto in Progettazione SSIS o in SQL Server, indicando che l'autenticazione con l'identità gestita di Azure Data Factory non funziona.

• Configurare in fase di esecuzione. Quando si esegue il pacchetto tramite SSMS o l'attività Esegui pacchetto SSIS nella pipeline di Azure Data Factory, individuare il gestore connessioni OLE DB e aggiornarne la proprietà ConnectUsingManagedIdentity su True.

  Nota

  In Azure-SSIS IR tutti gli altri metodi di autenticazione, ad esempio, sicurezza integrata e password, preconfigurati nella gestione connessione OLEDB vengono sostituiti quando si usa l'autenticazione di Microsoft Entra con un'identità gestita.

Per configurare l'autenticazione Microsoft Entra con l'identità gestita per Azure Data Factory nei pacchetti esistenti, l'approccio preferito consiste nel ricompilare il progetto di SSIS con la versione più recente di Progettazione SSIS almeno una volta. Ridistribuire il progetto SSIS per l'esecuzione in Azure-SSIS IR, in modo che la nuova proprietà ConnectUsingManagedIdentity di gestione connessione venga aggiunta automaticamente a tutte le gestioni connessione OLEDB nel progetto. In alternativa, è possibile utilizzare le sostituzioni delle proprietà, con il percorso proprietà \Package.Connections[{the name of your connection manager}].Properties[ConnectUsingManagedIdentity] impostato su True in fase di esecuzione.

Vedi anche

• Origine dati OLE DB
• Destinazione OLEDB
• Connessioni di Integration Services (SSIS)