Condividi tramite

Creare l'URI di connessione SQL Server

  • Articolo

L'adapter Microsoft BizTalk per SQL Server URI di connessione contiene proprietà utilizzate dall'adapter per stabilire una connessione al database SQL Server. In questo argomento vengono fornite informazioni sull'URI di connessione SQL Server e vengono forniti collegamenti ad altri argomenti che illustrano come specificare un URI in scenari di programmazione diversi.

URI di connessione per l'adapter SQL

Un URI di indirizzo endpoint tipico in WCF è rappresentato come : scheme://hostinfoparams?query_string, dove:

  • scheme è il nome dello schema.

  • hostinfoparams è informazioni necessarie per stabilire la connessione all'host; Ad esempio, un nome del server.

  • query_string è una raccolta facoltativa nome-valore di parametri delimitati da un punto interrogativo (?).

    L'URI di connessione dell'adapter SQL è conforme a questo formato di base e viene implementato come segue:

  
mssql://[Server_Name[:Portno]]/[Database_Instance_Name]/[Database_Name]?FailoverPartner=[Partner_Server_Name]&InboundId=[Inbound_ID]

dove, mssql è lo schema per l'URI di connessione SQL Server.

Nella tabella seguente vengono illustrate le proprietà contenute nell'URI di connessione.

Connection URI, proprietà Category Descrizione
[SERVER_NAME] hostinfoparams Nome del server in cui è installato SQL Server. Se non si specifica un valore, l'adattatore presuppone che il nome del server sia "localhost" e stabilisca una connessione con il database SQL Server nel server locale.
[PORTNO] hostinfoparams Numero di porta in cui viene stabilita la connessione. Se non si specifica un valore, l'adattatore si connette tramite la porta predefinita.
[DATABASE_INSTANCE_NAME] hostinfoparams Nome dell'istanza di SQL Server a cui connettersi. Se non si specifica un valore, l'adattatore si connette all'istanza di database predefinita.
[DATABASE_NAME] hostinfoparams Nome del database a cui connettersi. Se non si specifica un valore, l'adattatore si connette al database predefinito.
[PARTNER_SERVER_NAME] query_string Nome del database di SQL Server di failover a cui connettersi se il database SQL Server primario non è disponibile. Per altre informazioni sulla disponibilità elevata per quanto riguarda SQL Server, vedere Mirroring del database in SQL Server.
[INBOUND_ID] query_string Identificatore aggiunto all'URI di connessione per renderlo univoco. È necessario specificare questo parametro di connessione se si desidera generare metadati per l'operazione typedPolling in ingresso. Inoltre, in un'applicazione BizTalk, se si dispone di più posizioni di ricezione che eseguono il polling dello stesso database, l'ID in ingresso rende univoco l'URI di connessione, consentendo così ai client dell'adapter di ricevere messaggi di polling dallo stesso database in posizioni di ricezione diverse. Per altre informazioni, vedere Ricevere messaggi di polling tra più porte di ricezione da SQL tramite BizTalk Server.

Nota

Per altre informazioni su queste proprietà stringa di connessione, vedere Proprietà SqlConnection.ConnectionString.

SQL Server credenziali e URI di connessione

L'adapter SQL non supporta la specifica delle credenziali nell'URI di connessione. Per altre informazioni sulla specifica delle credenziali nelle applicazioni che usano l'adapter SQL, vedere Proteggere le applicazioni SQL.

Uso di caratteri speciali nell'URI di connessione

L'adattatore SQL non supporta la specifica di un URI di connessione con caratteri speciali per uno dei valori dei parametri. Se i valori dei parametri di connessione contengono caratteri speciali, assicurarsi di eseguire una delle operazioni seguenti:

  • Se si specifica l'URI in Visual Studio tramite plug-in Add Adapter Service Reference o Consume Adapter Service Add-in , è necessario specificarli così come sono nella scheda Proprietà URI , ovvero senza usare caratteri di escape. Se si specifica l'URI direttamente nel campo Configura un URI e i parametri di connessione contengono caratteri speciali, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.

    Ad esempio, se l'URI di connessione ha un parametro con nome sql server, è necessario specificarlo come sql%20server.

  • Se si specifica l'URI durante la creazione di una porta di trasmissione o ricezione nella console di amministrazione di BizTalk Server e i parametri di connessione contengono caratteri speciali, è necessario specificare i parametri di connessione usando caratteri di escape appropriati.

Uso dell'URI di connessione per connettersi al database SQL Server

Di seguito è riportato un URI di connessione di esempio per l'adapter SQL.

mssql://sql_server/sql_server_instance//

Nell'esempio precedente , "sql_server" è il nome del computer in cui è installato SQL Server, mentre "sql_server_instance" è il nome dell'istanza del database a cui connettersi. Poiché non viene specificato alcun nome di database, l'adapter si connetterà al database predefinito.

Di seguito è riportato un esempio di URI di connessione in cui il database SQL Server è installato nello stesso computer dell'adapter SQL. In questo esempio, l'adattatore si connette al database "my_database" per l'istanza del database "sql_server_instance" nel computer locale.

mssql://localhost/sql_server_instance/my_database/

In questo esempio, l'adattatore si connette al database predefinito per l'istanza predefinita in esecuzione nel computer locale.

mssql://localhost///

Per informazioni su come specificare una connessione al database SQL Server quando:

Vedere anche

Sviluppare applicazioni SQL personali