Esplorare, cercare e ottenere metadati per le operazioni SQL usando l'adapter SQL

In questa sezione vengono fornite informazioni su come usare il componente aggiuntivo del progetto BizTalk per il servizio Consume Adapter, la Creazione guidata per l'aggiunta dei metadati dell'adapter e il Plug-in di Visual Studio per aggiungere il riferimento al servizio adapter. Usando questi componenti di Visual Studio, è possibile:

• Cerca le operazioni da cui recuperare i metadati.

• Cercare le operazioni per cui recuperare i metadati.

• Aggiungere schemi di messaggio per le operazioni selezionate e i file di configurazione del binding delle porte a un progetto BizTalk Server quando si utilizza l'add-in Consume Adapter Service.

• Aggiungere una classe client WCF o un contratto di servizio WCF (interfaccia) per le operazioni selezionate e un file di configurazione (app.config) a un progetto di programmazione non BizTalk quando si utilizza il plug-in di riferimento al servizio dell'adattatore.

Prerequisiti

È necessario connettersi a SQL Server prima di poter esplorare, cercare o recuperare i metadati per le operazioni di destinazione. Per informazioni su come connettersi a SQL Server quando si usa il componente aggiuntivo Consume Adapter Service, la Procedura guidata Aggiungi metadati dell'adapter o il plug-in Aggiungi riferimento al servizio adapter, vedere Connettersi a SQL Server in Visual Studio tramite il componente aggiuntivo Consume Adapter Service.

Navigazione delle operazioni

È possibile utilizzare il componente aggiuntivo del servizio adapter Consume, la procedura guidata Add Adapter Metadata Wizard o il plug-in Add Adapter Service Reference per cercare le operazioni in uscita e in ingresso che possono essere eseguite in SQL Server tramite l'adapter SQL.

Operazioni in uscita

L'adapter SQL consente ai client di eseguire le operazioni in uscita seguenti.

• Operazioni di inserimento, selezione, aggiornamento ed eliminazione su tabelle e viste.

• Imposta operazioni<column_name> su tabelle e viste. Questa operazione viene esposta nelle tabelle con colonne di varchar(max), nvarchar(max) o varbinary(max). Tali operazioni consentono lo streaming di oggetti di grandi dimensioni.

• Stored procedure, sia debolmente che fortemente tipizzate come operazioni.

• Funzioni scalari e con valori di tabella come operazioni.

  L'adapter espone anche le operazioni in uscita generiche, ad esempio ExecuteReader, ExecuteScalar e ExecuteNonQuery a livello radice.

Operazioni in ingresso

L'adapter SQL consente ai client di eseguire le operazioni in ingresso seguenti.

• Operazione di polling per ricevere messaggi di modifica dei dati basati sul polling da SQL Server. I messaggi ricevuti per questa operazione non sono a tipizzazione forte.

• Operazione TypedPolling per ricevere messaggi di modifica dei dati basati sul polling da SQL Server. I messaggi ricevuti per questa operazione sono fortemente tipizzati.

• Operazione di notifica per ricevere notifiche di query da SQL Server.

Per altre informazioni su queste operazioni, vedere Connettersi a un sistema SAP usando l'adapter.

Per altre informazioni sull'esplorazione dei metadati, vedere Ottenere metadati per le operazioni di SQL Server in Visual Studio tramite l'adapter SQL.

Per esplorare le operazioni in uscita in SQL Server

1. Connettersi a SQL Server tramite il componente aggiuntivo Consume Adapter Service, l'Add Adapter Metadata Wizard o il plug-in Add Adapter Service Reference. Per istruzioni, vedere Connettersi a SQL Server in Visual Studio usando il componente aggiuntivo Consume Adapter Service.

2. Nell'elenco Seleziona tipo di contratto selezionare Client (operazioni in uscita) per le operazioni in uscita.

3. Nella casella Selezionare una categoria sono elencati gli artefatti disponibili nel database di SQL Server a cui ci si connette. Fare clic su un artefatto per visualizzare le operazioni disponibili per tale artefatto nella casella Categorie e operazioni disponibili .

   Suggerimento

   È possibile passare direttamente al nodo di categoria "immediata" o ai nodi della sottocategoria nell'albero digitando il nome dell'artefatto, mentre il focus è sulla vista ad albero nella casella Seleziona una categoria. Ad esempio, per passare al nodo Employee, mantenere lo stato attivo sul nodo Tabelle e quindi digitare Employee.

   La figura seguente mostra il componente aggiuntivo Consume Adapter Service. Il nodo radice (/) è selezionato e i nodi di categoria generali disponibili nel nodo radice sono elencati nella casella Categorie e operazioni disponibili .

   

   Annotazioni

   Le operazioni standard di SQL Server, ad esempio ExecuteReader, ExecuteScalar e ExecuteNonQuery, sono disponibili anche a livello radice. Per altre informazioni su queste operazioni, vedere Supporto per le operazioni ExecuteNonQuery, ExecuteReader e ExecuteScalar.

4. Per visualizzare le procedure disponibili nel database di SQL Server, fare clic sul nodo Procedure . Nella figura seguente il nodo Procedure viene selezionato nella casella Seleziona una categoria e le procedure corrispondenti sono elencate nella casella Categorie e operazioni disponibili.

   

   Annotazioni

   Lo stesso set di procedure elencate nel nodo Procedure è disponibile anche nel nodo Procedure Tipizzate. La differenza consiste nel modo in cui viene generato lo schema. Per una procedura sotto il nodo Procedure, lo schema è debolmente tipizzato. Tuttavia, per una procedura nel nodo Strongly-Typed Procedure, lo schema viene fortemente tipizzato. Lo schema fortemente tipizzato è utile se si vuole eseguire il mapping dello schema di un'operazione a un'altra operazione usando il mapper BizTalk perché lo schema è disponibile in fase di progettazione durante la creazione del progetto BizTalk. Per le procedure di tipo debole, lo schema per la routine viene ricevuto in fase di esecuzione come parte del messaggio di risposta.

5. Per visualizzare le tabelle nel database di SQL Server, fare clic sul nodo Tabelle . In alternativa, espandere il nodo Tabelle .

6. Per visualizzare le operazioni supportate nella tabella, fare clic su un nome di tabella.

   La figura seguente mostra un elenco di tabelle nella casella Selezionare una categoria . Nella casella Categorie e operazioni disponibili sono elencate le operazioni supportate per una tabella selezionata.

   

   Annotazioni

   Se una tabella di SQL Server contiene colonne di tipo varchar(max), nvarchar(max) e varbinary(max), l'adapter espone anche un'operazione specifica per aggiornare i dati in tale colonna. Il nome di questa operazione è Set<column_name>. Ad esempio, se la tabella ha una colonna "Job_Description" di tipo varchar(MAX), il nome dell'operazione è "SetJob_Description".

7. Per visualizzare le viste nel database di SQL Server, fare clic sul nodo Viste . In alternativa, espandere il nodo Visualizzazioni .

8. Per visualizzare le operazioni supportate nella visualizzazione, fare clic su un nome di visualizzazione.

   La figura seguente mostra un elenco di visualizzazioni nella casella Selezionare una categoria . Nella casella Categorie e operazioni disponibili sono elencate le operazioni supportate per una visualizzazione selezionata.

   

   Annotazioni

   Se una vista contiene colonne di tipo varchar(max), nvarchar(max) e varbinary(max), l'adapter espone anche un'operazione specifica per aggiornare i dati in tale colonna. Il nome di questa operazione è Set<column_name>. Ad esempio, se la tabella ha una colonna "Job_Description" di tipo varchar(max), il nome dell'operazione è "SetJob_Description".

9. Per visualizzare l'elenco delle funzioni scalari definite nel database di SQL Server nella casella Categorie e operazioni disponibili , fare clic sul nodo Funzioni scalari .

   Nella figura seguente viene selezionato il nodo Funzioni scalari nella casella Seleziona una categoria e le funzioni corrispondenti sono elencate nella casella Categorie e operazioni disponibili .

   

10. Per visualizzare l'elenco delle funzioni con valori di tabella definite nel database di SQL Server nella casella Categorie e operazioni disponibili , fare clic sul nodo Funzioni con valori di tabella .

    Nella figura seguente il nodo Funzioni con valori di tabella è selezionato nella casella Seleziona una categoria e le funzioni corrispondenti sono elencate nella casella Categorie e operazioni disponibili .

    

Per esplorare le operazioni in ingresso in SQL Server

1. Connettersi a SQL Server utilizzando il componente aggiuntivo Consume Adapter Service, la procedura guidata Aggiungi metadati dell'adapter o il plug-in Aggiungi riferimento al servizio dell'adapter. Per istruzioni, vedere Connettersi a SQL Server in Visual Studio usando il componente aggiuntivo Consume Adapter Service.

2. Nell'elenco Seleziona tipo di contratto selezionare Servizio (operazioni in ingresso) per le operazioni in ingresso.

3. Tutte le operazioni in ingresso supportate dall'adapter SQL sono disponibili nel nodo radice. Fare clic sul nodo radice (/) per visualizzare le operazioni in ingresso disponibili.

   

Ricerca di operazioni

È possibile usare il componente aggiuntivo Consumo servizio adapter, l'Aggiungi guidata metadati adapter o il plug-in Aggiungi riferimento al servizio adapter per cercare artefatti specifici nel database di SQL Server. Quando si esaminano i metadati di SQL Server, l'adattatore SQL:

• Supporta caratteri jolly e caratteri di escape nell'espressione di ricerca.

• Abilita la ricerca immediatamente sotto il nodo in cui viene eseguita l'operazione di ricerca. Ad esempio, per cercare una tabella, è necessario eseguire una ricerca in \Table. La ricerca a più livelli non è supportata.

  Nella tabella seguente sono elencati i caratteri speciali che possono essere usati per la ricerca di elementi e la relativa interpretazione da parte dell'adapter SQL.

Per altre informazioni, vedere Ottenere metadati per le operazioni di SQL Server in Visual Studio tramite l'adapter SQL.

Per cercare i metadati in SQL Server usando il componente aggiuntivo Consume Adapter Service , seguire questa procedura.

Per eseguire ricerche nei metadati in SQL Server

1. Connettersi a SQL Server utilizzando il componente aggiuntivo Consume Adapter Service, la procedura guidata Aggiungi metadati dell'adapter o il plug-in Aggiungi riferimento al servizio dell'adapter. Per istruzioni, vedere Connettersi a SQL Server in Visual Studio utilizzando il componente aggiuntivo Consume Adapter Service.

2. Nell'elenco Seleziona tipo di contratto selezionare il tipo di contratto in base alla ricerca di operazioni in ingresso o in uscita.

3. Nella casella Seleziona una categoria fare clic sul nodo categoria in cui si desidera cercare un artefatto specifico. Ad esempio, per cercare una tabella, fare clic sul nodo Tabelle .

4. Nella casella Cerca nella categoria digitare un'espressione di ricerca per cercare un artefatto specifico. Ad esempio, per cercare le tabelle con "Customer" nel nome, digitare %Customer%.

   Annotazioni

   La stringa di ricerca fa distinzione tra maiuscole e minuscole.

5. Per avviare la ricerca, fare clic sul pulsante con l'icona a forma di freccia destra. Al termine della ricerca, nella casella Categorie e operazioni disponibili sono elencati gli artefatti che soddisfano i criteri di ricerca.

   La figura seguente mostra le tabelle di SQL Server che contengono "Customer" nel nome.

   

Generazione di schemi per progetti BizTalk

Per generare lo schema per gli artefatti selezionati di SQL Server, è possibile utilizzare il componente aggiuntivo *Consume Adapter Service Add-in* o la procedura guidata *Add Adapter Metadata Wizard*. Dopo aver esplorato e cercato gli artefatti che si desidera richiamare, è possibile generare lo schema per tali artefatti e inviare messaggi, conformi allo schema, a SQL Server.

Per generare lo schema per gli artefatti di SQL Server

1. Connettere a SQL Server utilizzando il componente aggiuntivo Consume Adapter Service o la procedura guidata dei metadati dell'adapter. Per istruzioni, vedere Connettersi a SQL Server in Visual Studio usando il componente aggiuntivo Consume Adapter Service.

   Importante

   Per generare lo schema per l'esecuzione di operazioni tramite BizTalk Server, è necessario impostare la proprietà di associazione EnableBizTalkCompatibilityMode su True. È necessario impostare questa proprietà di associazione durante la creazione di una connessione al database di SQL Server.

2. Nell'elenco Seleziona tipo di contratto selezionare il tipo di contratto in base alla generazione dello schema per le operazioni in ingresso o in uscita.

3. Fare clic sul nodo della categoria per cui si desidera generare i metadati. Ad esempio, se si desidera generare metadati per una tabella, fare clic su Tabelle.

4. Espandere il nodo della categoria e selezionare l'elemento specifico all'interno del nodo per cui si desidera generare i metadati. Ad esempio, per generare metadati per le operazioni nella tabella "CustomerTable", espandere il nodo Tabelle e quindi fare clic su CustomerTable.

5. Nella casella Categorie e operazioni disponibili selezionare le operazioni da eseguire in SQL Server e quindi fare clic su Aggiungi. Le operazioni selezionate sono elencate nella casella Categorie e operazioni aggiunte . Ad esempio, per eseguire operazioni di inserimento e selezione nella tabella "CustomerTable", fare clic sui nomi delle operazioni e quindi su Aggiungi.

   Nella figura seguente viene illustrato il componente aggiuntivo Consume Adapter Service ,che elenca le operazioni selezionate.

   

   Se si desidera generare lo schema per più operazioni, potrebbero essere presenti alcune definizioni di elementi duplicati tra questi schemi che potrebbero causare errori durante la compilazione del progetto BizTalk. Si consideri, ad esempio, uno scenario in cui si genera lo schema per un'operazione "Op1". Lo schema per "Op1" contiene un parametro di tipo di dati "CT1". Dopo aver generato lo schema per "Op1", chiudere il componente aggiuntivo Consume Adapter Service e riaprirlo per generare lo schema per un'altra operazione "Op2". Si supponga che "Op2" contenga anche un parametro di tipo di dati "CT1". Dopo aver chiuso il componente aggiuntivo Consume Adapter Service e compilato il progetto, si otterranno errori di compilazione perché il tipo di dati complesso "CT1" viene definito due volte in file XSD diversi. In tali situazioni, è consigliabile:

   • Generare lo schema per tutte le operazioni in una singola esecuzione del componente aggiuntivo Consume Adapter Service. In questo modo, il componente aggiuntivo Consume Adapter Service genera una sola definizione per il tipo di dati complesso "CT1".

   • Se si desidera generare lo schema per più operazioni in esecuzioni diverse del componente aggiuntivo consume adapter service, assicurarsi di selezionare la casella di controllo Genera tipi di schema univoci , in modo che i file XSD generati contengano spazi dei nomi univoci per il tipo di dati complesso "CT1".

6. Fare clic su OK. Il file di schema viene salvato con estensione xsd nella stessa posizione del progetto BizTalk.

   Annotazioni

   Se si usa il componente aggiuntivo Consume Adapter Service per generare metadati per gli artefatti di SQL Server, per impostazione predefinita i file vengono creati con una convenzione di denominazione specifica. Il file WSDL generato contiene un tag di annotazione fileNameHint che include il nome che deve essere assegnato al file XSD. Ad esempio, un hint per il nome di file per un file di schema per l'operazione di tabella segue la convenzione TableOperation.<schema>.<tablename>. Se si desidera personalizzare il nome del file XSD generato, è possibile specificare un prefisso nella casella Prefisso nome file . Infine, il nome di un file XSD viene determinato come prefisso del nome file + fileNameHint + numero intero univoco (se necessario, per assicurarsi che il nome del file sia univoco).

   Annotazioni

   Il componente aggiuntivo Consume Adapter Service crea anche un file di associazione (un file XML) contenente le proprietà di associazione specificate durante la generazione dello schema per un'operazione e l'azione SOAP per richiamare l'operazione. È possibile importare questo file di associazione nella console di amministrazione di BizTalk Server per creare una porta WCF-Custom o una porta dell'adapter SQL BizTalk con l'URI di connessione, le proprietà di associazione e il set di azioni SOAP. Per altre informazioni, vedere Configurare un'associazione di porte fisiche usando un file di associazione di porte per l'uso dell'adapter SQL.

   I metadati sono stati generati correttamente per gli artefatti di SQL Server. È possibile usare i metadati per inviare messaggi a SQL Server per eseguire operazioni specifiche. Per altre informazioni su come eseguire queste operazioni, vedere Sviluppare applicazioni BizTalk usando l'adapter SQL .

Generazione di un client WCF o di un contratto di servizio WCF tramite il plug-in Add Adapter Service Reference

È possibile usare il plug-in Referente di Servizio Adapter per generare il codice client WCF per le operazioni in uscita o il codice del servizio WCF per le operazioni in entrata.

Per generare la classe client WCF o il contratto di servizio per le operazioni di SQL Server

1. Nel plug-in Aggiungi riferimento al servizio adapter, dall'elenco a discesa Seleziona tipo di contratto, selezionare il tipo di contratto in base al fatto che si eseguiranno operazioni in ingresso o in uscita.

2. Esplorare o cercare categorie (ad esempio una tabella di database) o per le operazioni specifiche per cui si vuole generare un client WCF (o un contratto di servizio WCF).
   Ad esempio, per cercare le operazioni nella tabella Employee , nella casella Selezionare una categoria :

   1. Espandere il nodo radice (/) per visualizzare le categorie in cui vengono visualizzate le operazioni per un database di SQL Server.

   2. Nel nodo radice espandere il nodo Tabelle per visualizzare le tabelle disponibili.

3. Fare clic sul nodo Tabella Employee e nella casella Categorie e operazioni disponibili selezionare le operazioni o le categorie per cui si desidera generare un client WCF (o un contratto di servizio WCF) e quindi fare clic su Aggiungi. Le operazioni selezionate sono elencate nella casella Categorie e operazioni aggiunte .

   Nella figura seguente viene illustrato il plug-in Aggiungi riferimento al servizio adapter con le operazioni Inserisci e Seleziona per la tabella Employee selezionata.

   Creare un contratto di client o di servizio WCFsql_adap_add_adap_serv_ref

   Importante

   A seconda delle operazioni in uscita (o delle categorie) selezionate, è possibile generare più classi client WCF. Per altri dettagli, vedere Generare un client WCF o un contratto di servizio WCF per gli artefatti di SQL Server.

4. Per la maggior parte degli scenari, le opzioni di serializzazione predefinite sono sufficienti; Tuttavia, se necessario, è possibile controllare diversi aspetti sul codice generato e sul tipo di serializzatore usato. Per impostare queste opzioni:

   1. Fare clic su Opzioni avanzate per aprire la casella Opzioni avanzate .

   2. Nella casella Opzioni avanzate in Scegliere le opzioni per il proxy generato selezionare le opzioni desiderate. Ad esempio, è possibile selezionare se vengono generati metodi asincroni per il client WCF o disabilitare la generazione di un file di configurazione.

   3. In Serializer selezionare il serializzatore da usare.

      La figura seguente mostra la casella Opzioni avanzate con le selezioni predefinite (l'opzione Auto è selezionata per il serializzatore e non sono selezionate altre opzioni).

      

      Le opzioni che è possibile configurare nella casella Opzioni avanzate sono equivalenti ad alcune delle opzioni disponibili quando si usa lo strumento Utilità metadati ServiceModel (svcutil.exe). Per altre informazioni su queste opzioni, vedere ServiceModel Metadata Utility Tool (Svcutil.exe).

5. Fare clic su OK. Il plug-in Aggiungi Riferimento al Servizio Adattatore salva la classe client WCF (o l'interfaccia del servizio WCF) e il codice helper per le operazioni e le categorie che hai selezionato nella directory del progetto. Per impostazione predefinita, viene salvato anche un file di configurazione. I file leggermente diversi vengono generati per le operazioni in ingresso e in uscita; Per altre informazioni, vedere Generare un client WCF o un contratto di servizio WCF per gli artefatti di SQL Server.

   È possibile selezionare qualsiasi nodo elencato nella casella Categorie e operazioni disponibili . Se si seleziona un nodo di categoria, verranno selezionate tutte le operazioni disponibili in tale nodo e i relativi nodi secondari. Ad esempio, per generare un client WCF per tutte le operazioni rilevate per la tabella Employee, è possibile selezionare il nodo Employee.

Vedere anche

Ottenere i metadati per le operazioni di SQL Server in Visual Studio usando l'adapter SQL