Przy użyciu języka WSDL
Ta funkcja zostanie usunięta z przyszłej wersji programu Microsoft SQL Server. Należy unikać stosowania tej funkcji w nowych projektach oraz zaplanować modyfikację aplikacji, w których obecnie jest używana ta funkcja.
Języka Web Service Description Language (WSDL) definiuje definicji interfejs Web dla dowolnej funkcji RPC narażonych na punkt końcowy HTTP, a także opis funkcji partia SQL dla punktu końcowego.Klient może żądać odpowiedzi WSDL z wystąpienie z SQL Server i używać go do generowania żądań wsadowych SQL i RPC na serwerze przy użyciu punktów końcowych HTTP, które zostały skonfigurowane do obsługi typu WSDL.Odpowiedź WSDL jest rzeczywiście generowanych dynamicznie dokumentu XML opartego na funkcji RPC skojarzonych z punktem końcowym w czas żądania.
Ostrzeżenie
Aby informacje dotyczące języka WSDL, zobacz specyfikację 1.1 języka WSDL, dostępne witryna sieci Web World Wide Web Consortium (W3C) w http://www.w3c.org.
Punkty końcowe HTTP, które są skonfigurowane do obsługi oferowania WSDL, można określić jedną z następujących konfiguracji WSDL do użytku w odpowiadający klientom, których przesyłanie żądań WSDL:
Domyślnie WSDL
Dostosowane WSDL
Gdy opcja domyślna WSDL dostarczać SQL Server oferuje obsługę dwóch typów WSDL: Domyślnie lub rozszerzone WSDL i uproszczony format WSDL.
Chociaż jeden z tych dokumentów WSDL opisać metody, które są obsługiwane dla punktu końcowego, domyślne WSDL używa dodatkowych funkcji z pliku schematu XML (XSD) zapewnia bogatsze opis metod, typy danych, parametrów i zwracanych wartości są dostępne lub narażonych przez punkt końcowy.
Format WSDL uproszczonej może być wymagane dla niedziałający-poziom zgodności ze starszymi klientami używa bardzo podstawowego schematu XSD, który wymaga tylko podstawowych typów danych.Domyślnie ani uproszczone WSDL zawiera dokładną zawartość WSDL właściwe dla danego klient, po zaktualizowaniu serwera do obsługi dostosowaną wersja WSDL wymagane.
Reakcje WSDL są generowane i zwracane przez wystąpienie SQL Server przy początkowym połączeniu do punktu końcowego HTTP przez klient usługi sieci Web, który przesyła żądanie WSDL.
Jak WSDL jest obsługiwany przez program SQL Server
When an endpoint is defined, the WSDL argument in the CREATE ENDPOINT Transact-SQL statement is used to specify for the server whether a WSDL response is generated and returned for the endpoint to describe its Web programmable features.Jeśli punkt końcowy została ustalona przy użyciu WSDL = wartość Brak, serwer nie zwróci odpowiedzi WSDL.
Jeśli domyślny WSDL generacji określono, takich jak if WSDL = domyślne określono podczas tworzenia punktu końcowego, format języka WSDL, zwracane przez serwer zależy ciąg adres URL używany przez klient, aby połączyć punkt końcowy HTTP.Klienci mogą używać jednego z następujących formatów adresu URL żądania pliku WSDL:
Domyślnie WSDL
Jest to pełna wersja rozszerzone odpowiedź WSDL, która jest zwracana, gdy używasz http://server/endpoint_path? wsdl adres URL, aby połączyć się z punktem końcowym.Ten format używa typów pochodnych XSD zapewnia obsługę mapowanie bardziej złożone typy SQL.Aby uzyskać więcej informacji, zobacz Domyślnie WSDL.
Proste WSDL
Jest to krótki uproszczoną wersja domyślną WSDL, który mapuje wszystkie SQL Server typów danych do rodzimych typów XSD.Ten format jest zwracana, gdy używasz http://server/endpoint_path? wsdlsimple jako adres URL, aby połączyć się z punktem końcowym.Aby uzyskać więcej informacji, zobacz Proste WSDL.
Niestandardowe WSDL
Podczas obu wersja pliku WSDL, wystąpienie SQL Server zwraca wartość domyślną lub uproszczone jeden jest nie do zaakceptowania dla klientów, można określić niestandardowe oferty WSDL.Ta opcja wymaga, projektowania i implementacji dodatkowy kod.W ten sposób procedura składowana może służyć do generowania i zwrócić dostosowaną zawartość WSDL wyniku klientom, które określają typ niestandardowy WSDL w kwerendzie oparte na protokole HTTP.Aby uzyskać więcej informacji, zobacz Implementowanie obsługi WSDL niestandardowe.
Zawartość pliku WSDL
Wystąpienie języka Web Services Description Language (WSDL) jest dokument XML z głównego <Definicje> element, który określa obszar nazw WSDL (https://schemas.xmlsoap.org/wsdl) i definiuje zestaw usług sieci Web jako kolekcja punkty końcowe sieci lub portów.Typowy dokument WSDL będą mieć następującą strukturę najwyższego poziom:
<wsdl:definitions>
<wsdl:types>...</wsdl:types>
<wsdl:message>...<wsdl:message/>
<wsdl:portType>...</wsdl:portType>
<wsdl:binding>...</wsdl:binding>
<wsdl:service>...<wsdl:service>
<wsdl:definitions>
Ilustruje to uproszczony widok WSDL format kilku elementów są używane do wskazywania głównych sekcji w dokumencie WSDL.Rola każdej z tych krótko opisano w poniższej tabela.
Element |
Opis |
|---|---|
wsdl:types |
Element kontenera dla definicji typu danych dokonane za pomocą schematu XML (XSD) lub inny podobny system dla typów danych. |
wsdl:message |
Definicja danych wiadomości wymienianych.Komunikat może składać się z wielu części i każdej części mogą być innego typu |
wsdl:portType |
Abstrakcyjna zestaw operacji obsługiwanych przez jeden lub więcej punktów końcowych. |
wsdl:binding |
Konkretny protokół i dane Specyfikacja formatu dla typu określonego portu. |
wsdl:service |
Kolekcja powiązanych punktów końcowych. |
System przechowywane procedury stosowane do obsługi języka WSDL
Następujące procedury składowane w systemie są dołączone macierzysty usług XML sieci Web w SQL Server do obsługi domyślne i prostych implementacjach WSDL i są wywoływane w odpowiedzi na żądanie dla WSDL:
sp_http_generate_wsdl_defaultcomplexorsimple
sp_http_generate_wsdl_defaultsimpleorcomplex
sp_http_generate_wsdl_complex
sp_http_generate_wsdl_simple
wykonać tych procedur przechowywanych, wymaga członkostwa w public rolę.Wewnętrznie każdy z tych procedur przechowywanych kwerendy katalogów, aby uzyskać informacje o dodatkowych procedur przechowywanych, dostępne za pośrednictwem punktów końcowych jako metody sieci Web.Użytkownicy potrzebują tylko uprawnień tych procedur przechowywanych metoda sieci Web.Aby uzyskać więcej informacji, zobacz Uwidacznianie programowania SQL w sieci Web.
Zobacz także