Sfogliare, cercare e ottenere metadati SQL Server
I metadati dell'adapter Microsoft BizTalk per SQL Server dal database SQL Server descrivono la struttura dei messaggi per comunicare con il database SQL Server usando l'adapter. L'adapter SQL supporta due interfacce per il recupero dei metadati.
MetadataExchange fornito da Windows Communication Foundation (WCF). WCF fornisce un endpoint di scambio dei metadati per tutte le associazioni WCF, che consente ai client di ottenere metadati dal database SQL Server.
IMetadataRetrievalContract fornito da Microsoft Windows Communication Foundation (WCF) Line of Business Adapter SDK (LOB), che supporta l'esplorazione dei metadati e le funzionalità di ricerca dell'adapter.
L'adattatore SQL visualizza gli artefatti del database SQL Server e le rispettive operazioni che i client della scheda possono richiamare. L'adapter esegue anche operazioni , ad esempio ExecuteNonQuery, ExecuteReader e ExecuteScalar, che possono essere usate per eseguire operazioni specifiche nel database SQL Server. Queste operazioni verranno illustrate più avanti in questo argomento.
Nota
L'adattatore SQL consente di visualizzare gli artefatti in tutti gli schemi nel database SQL Server a cui l'utente attualmente connesso ha accesso. Ciò implica che, a parte lo schema predefinito (dbo), i client dell'adapter possono anche eseguire operazioni sugli artefatti in altri schemi nel database SQL Server, a condizione che le credenziali utente usate per connettersi tramite l'adattatore SQL dispongano dell'accesso a tali schemi nel database SQL Server. Per informazioni su uno schema nel database SQL Server, vedere https://go.microsoft.com/fwlink/?LinkId=130148.
È possibile usare i client dell'adapter per esplorare, cercare e recuperare i metadati in base a:
Creazione di un progetto BizTalk in Visual Studio
Uso del modello di servizio WCF
Uso del modello di canale WCF
Quando si usa un progetto BizTalk, è necessario usare il componente aggiuntivo del progetto BizTalk del servizio adapter o Aggiungere metadati dell'adapter per generare metadati per le operazioni da eseguire nel database SQL Server. Quando si usa il modello di servizio WCF, è necessario usare il plug-in Add Adapter Service Reference Visual Studio per generare le classi proxy per eseguire operazioni sul database SQL Server. Per altre informazioni sull'esplorazione, la ricerca e il recupero dei metadati usando il componente aggiuntivo per il servizio adapter, Aggiungere la procedura guidata metadati dell'adapter o aggiungere plug-in di riferimento al servizio adapter, vedere Ottenere i metadati per le operazioni di SQL Server in Visual Studio usando l'adapter SQL.
Esplorazione dei metadati
La scheda SQL consente ai client della scheda di esplorare tabelle, viste, stored procedure e funzioni disponibili nel database SQL Server. Nell'ambito dell'operazione di esplorazione dei metadati, l'adapter visualizza anche le operazioni che possono essere eseguite nel database SQL Server, incluse alcune operazioni personalizzate supportate dagli adattatori. Queste operazioni sono disponibili dal componente aggiuntivo Per il servizio adapter, Aggiungi creazione guidata metadati adattatore o Plug-in di riferimento del servizio adapter. L'adattatore SQL illustra le operazioni seguenti:
Operazioni su tabelle, viste, procedure, funzioni scalari e funzioni con valori di tabella. Ad esempio, l'adattatore SQL può eseguire l'inserimento, l'aggiornamento, la selezione e l'eliminazione delle operazioni per la tabella EMPLOYEE.
L'operazione Imposta<nome> colonna per tabelle e visualizzazioni che consente ai client della scheda di scrivere valori di dati di grandi dimensioni in modo di streaming. L'operazione Set viene restituita solo per le tabelle e le visualizzazioni che contengono colonne con uno dei tipi di dati seguenti: Varchar(Max), Nvarchar(Max) o Varbinary(Max). Per altre informazioni, vedere Operazioni su tabelle e visualizzazioni che contengono tipi di dati di grandi dimensioni usando l'adapter SQL.
Le operazioni ExecuteNonQuery, ExecuteReader e ExecuteScalar che consentono ai client della scheda di eseguire istruzioni SQL arbitrarie in SQL Server. Per altre informazioni su queste operazioni, vedere Supporto per ExecuteNonQuery, ExecuteReader e ExecuteScalar Operations.
Le operazioni di polling e notifica per ricevere messaggi in ingresso da SQL Server. Per informazioni sull'operazione di polling, vedere Supporto per le chiamate in ingresso tramite polling; per informazioni sull'operazione di notifica, vedere Considerazioni sulla ricezione di notifiche di query tramite l'adapter SQL.
Per altre informazioni sul modo in cui i metadati sono classificati, vedere ID nodo metadati.
Ricerca di metadati
Con l'adattatore SQL è possibile eseguire una query di ricerca nel database SQL Server usando le espressioni di ricerca SQL Server compatibili con l'operatore LIKE. Ad esempio, i client della scheda possono usare un'espressione di ricerca, ad esempio "EMP%" per ottenere tabelle a partire da EMP. L'adapter converte questa operazione nella query SQL seguente:
SELECT TABLE_NAME FROM ALL_TABLES WHERE TABLE_NAME LIKE 'EMP%'
La tabella seguente elenca i caratteri speciali che possono essere usati per la ricerca e la relativa interpretazione dall'adapter SQL.
Carattere speciale | Interpretazione |
---|---|
_ (carattere di sottolineatura) | Corrisponde esattamente a un carattere. Ad esempio, "A_" corrisponde a "AB", "AC", "AD". |
% (percentuale) | Corrisponde a zero o più caratteri. Ad esempio, "A%" corrisponde a "A", "AB", "ABC". |
[ ] | - Escapes il significato speciale di _ e %. - Specifica un intervallo o un set di caratteri da presentare. Ad esempio: - %[%]% corrisponde a tutti i nomi che includono un simbolo %. - [a-f] corrisponde a tutti i nomi che hanno caratteri tra e tra 'a' e 'f'. - [abc] corrisponde a tutti i nomi con caratteri 'a', 'b' e 'c'. |
[^] | Specifica un intervallo o un set di caratteri che non devono essere presenti. Ad esempio: - [^a-f] corrisponde a tutti i nomi che non hanno caratteri tra e tra cui 'a' e 'f'. - [^abc] corrisponde a tutti i nomi che non hanno caratteri 'a', 'b' e 'c'. |
Importante
L'ambito di ricerca dei metadati è limitato al livello immediatamente sotto il nodo in cui viene eseguita l'operazione di ricerca. Ad esempio, per cercare una funzione scalare, è necessario eseguire la ricerca in /Funzione scalare/[Schema]. La ricerca a più livelli non è supportata.
Recupero dei metadati
Quando si recuperano metadati, l'adapter SQL può estrarre i metadati in uno schema, inclusi tutti o un subset di oggetti di database con i rispettivi parametri di oggetto e operazione. L'adapter presenta le entità del database SQL Server come nomi di elementi in XML. Poiché i caratteri di sottolineatura sono gli unici caratteri speciali consentiti che possono essere inclusi, tutti gli altri caratteri speciali nei nomi degli elementi vengono codificati usando caratteri di sottolineatura. Ad esempio, emp$name
viene codificato come emp_x0024_name
.
Vedere anche
Panoramica dell'adapter BizTalk per SQL ServerUnderstand BizTalk Adapter per i metadati SQL Server Get per le operazioni di SQL Server in Visual Studio usando l'adapter SQL