Condividi tramite

Creare l'URI di connessione di SQL Server

L'URI di connessione di Microsoft BizTalk Adapter per SQL Server contiene proprietà utilizzate dall'adapter per stabilire una connessione al database di SQL Server. In questo argomento vengono fornite informazioni sull'URI di connessione di 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 è un'informazione necessaria per stabilire la connessione all'host; ad esempio un nome del server.

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

    L'URI di connessione dell'adapter SQL è conforme a questo formato di base e viene implementato nel modo seguente:

  
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 di SQL Server.

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

Proprietà URI di connessione Categoria 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 di 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 SQL Server di failover a cui connettersi se il database di SQL Server primario non è disponibile. Per altre informazioni sulla disponibilità elevata rispetto a 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 in ingresso TypedPolling . 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 Ricezione di messaggi di polling tra più porte di ricezione da SQL tramite BizTalk Server.

Annotazioni

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

Credenziali di SQL Server 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'adapter 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 usando il plug-in Add Adapter Service Reference o Consume Adapter Service Add-in , è necessario specificarli as-is nella scheda Proprietà URI , ovvero senza utilizzare 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 di 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'adattatore si connetterà al database predefinito.

Di seguito è riportato un esempio di URI di connessione in cui il database di 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 di SQL Server quando si:

Vedere anche

Sviluppare applicazioni SQL

  • Last updated on