Aracılığıyla paylaş

  • Makale

WSDL kullanarak

This feature will be removed in a future version of Microsoft SQL Server. Avoid using this feature in new development work, and plan to modify applications that currently use this feature.

Web hizmet Açıklama Dili (WSDL) HTTP noktadaki kullandığı tüm RPC işlevleri için Web arabirim tanımı tanımlar ve bu da son nokta için SQL toplu iş iş işlevlerini açıklar.Bir istemci bir örneğinden WSDL yanıt iste SQL Server ve bir WSDL türünü desteklemek üzere yapılandırılmış HTTP bitiş noktası'nı kullanarak sunucu karşı RPC ve SQL toplu iş istekleri oluşturmak için kullanın. Isteğin saat son noktayla ilişkili RPC işlevlerini temel gerçekte bir dinamik olarak oluşturulan XML belgesi WSDL yanıttır.

Not

WSDL hakkında bilgi için World Wide Web Konsorsiyumu (W3C) Web sitesinde kullanılabilir WSDL 1.1 belirtimini bakın. http://www.W3C.org.

Bir WSDL sunan desteklemek üzere yapılandırılan bir HTTP bitiş noktaları, WSDL istekleri yanıtlama istemcilerinin kullanmak için aşağıdaki WSDL yapılandırmalardan birini belirtebilirsiniz:

  • Varsayılan BIR WSDL

  • Özelleştirilmiş bir WSDL

WSDL varsayılan seçenek sağlamak üzere yapılandırıldığında SQL Server Fırsatlar için iki WSDL türlerini destekler: Basitleştirilmiş bir WSDL, varsayılan veya genişletilmiş WSDL biçimlendirebilirsiniz.

Aşağıdakilerden biri bu WSDL belgeleri açıklamak karşın bu son noktadaki desteklenen yöntemler, WSDL varsayılan yöntemi, veri türleri, Parametreler, daha zengin bir tanım girin ve bitiş noktası tarafından açılmış veya kullanılabilir olmayan değerler döndürmek için ek özellikler, bir XML Schema (XSD) kullanır.

Alt düzey uyumluluğunu ve eski istemcilerin gerekebilir, Basitleştirilmiş WSDL biçimi, yalnızca temel veri türü gerektiren çok basit bir XSD şeması kullanır.Belirli bir istemci için uygun tam WSDL içeriği sağlarsa, varsayılan ya da Basitleştirilmiş WSDL gerektiği gibi WSDL, özelleştirilmiş bir sürüm sağlamak için sunucu güncelleştirebilirsiniz.

WSDL yanıtları oluşturulan ve örnek tarafından döndürülen SQL Server Web Hizmetleri istemcisi tarafından bir HTTP bitiş noktası için ilk bağlantı yapıldığında, bir WSDL isteği gönderir.

Nasıl, WSDL SQL Server tarafından desteklenen

When an endpoint is defined, the WSDL argument in the CREATE ENDPOINTTransact-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.Bitiş noktası bir WSDL kullanarak kurulan, NONE değeri = sunucu WSDL yanıt verecektir.

Varsayılan WSDL oluşturma, if gibi belirtildi, WSDL = bitiş noktası oluşturulduğunda, VARSAYıLAN belirtildi, sunucu tarafından döndürülen WSDL biçimi, istemci tarafından HTTP bitiş noktasına bağlanmak için kullanılan URL dizesi bağlı olarak değişir.Istemcilerin WSDL'I istemek için aşağıdaki URL biçimlerinden birini kullanabilirsiniz:

  • Varsayılan WSDL

    Bu tam olarak kullandığınızda, döndürülen genişletilmiş WSDL sürüm http://sunucu/endpoint_path? wsdl URL'bitiş noktasına bağlanma.Bu biçim, eşleme için daha karmaşık SQL türlerini desteklemek için türetilmiş XSD türü kullanır.Daha fazla bilgi için bkz:Varsayılan WSDL.

  • Basit bir WSDL

    Kısa Basitleştirilmiş bir sürüm tüm eşleyen bir WSDL varsayılan budur. SQL Server Sistem veri türleri için yerel bir XSD türü. Bu biçim, kullandığınız döndürülür http://sunucu/endpoint_path? wsdlsimple olarak bitiş noktasına bağlanma URL'SI.Daha fazla bilgi için bkz:Basit bir WSDL.

  • Özel WSDL

    Her iki sürüm WSDL'I, örnek SQL Server verir, ya varsayılan, basit bir istemci için kabul edilebilir değil, özel bir WSDL seçeneği belirtebilirsiniz. Bu seçenek, tasarlayın ve ek kod uygulamanız gerekir.Bu şekilde bir saklı yordam oluşturmak ve özelleştirilmiş WSDL içeriği HTTP tabanlı bir sorguda sonuç olarak özel WSDL belirttiğiniz istemcilerine yazın dönmek için kullanılabilir.Daha fazla bilgi için bkz:Uygulama özel WSDL desteği.

WSDL'I içeriği

XML belgesinin kök olan BIR Web Hizmetleri Açıklama Dili (WSDL) örnek <Tanımlar> WSDL ad (belirten bir öğehttps://schemas.xmlsoap.org/WSDL) ve tanımlayan bir küme Web Hizmetleri olarak ağ uç noktalarının veya bağlantı noktalarını topluluğudur. Tipik bir WSDL belgesi, aşağıdaki en üst düzey yapısını gerekir:

<wsdl:definitions>
  <wsdl:types>...</wsdl:types>
  <wsdl:message>...<wsdl:message/>
  <wsdl:portType>...</wsdl:portType>
  <wsdl:binding>...</wsdl:binding>
  <wsdl:service>...<wsdl:service>
<wsdl:definitions>

Bu basit görünüm WSDL biçimini gösterir, çeşitli öğeleri WSDL belgesi içinde ana bölümleri belirtmek için kullanılır.Aşağıdaki tabloda her Bu rolün kısaca açıklanmaktadır.

Element

Açıklama

wsdl:types

Kapsayıcı öğe XML Schema (XSD) veya başka bir benzer sistem veri türleri kullanılarak yapılan veri türü tanımlarının.

wsdl:message

Iletilen ileti veri tanımı.Iletinin birden çok bölümlerini yapılabilir ve her bir bölümü farklı bir tür olabilir.

wsdl:portType

Soyut bir veya daha fazla bitiş noktası tarafından desteklenen işlemleri kümesi.

wsdl:binding

Beton protokol ve veri biçim belirtimi için bir özel bağlantı noktası türü.

wsdl:service

Ilgili son noktalar koleksiyon.

Destek için kullanılan yordamlar Sistem saklı WSDL

Aşağıdaki sistem saklı yordamları, yerel XML Web hizmetleriyle birlikte gelen SQL Server Varsayılan basit WSDL uygulamaları ve öğeler'i desteklemek için bir isteğe yanıt olarak için WSDL çağırdı:

  • sp_http_generate_wsdl_defaultcomplexorsimple

  • sp_http_generate_wsdl_defaultsimpleorcomplex

  • sp_http_generate_wsdl_complex

  • sp_http_generate_wsdl_simple

Bu saklı yordamları yürütmek için üyelik gerektirir Ortak roldür.Dahili olarak, her biri Bu saklı yordamları katalogları olarak Web yöntemlerini bitiş noktaları aracılığıyla gösterilen ek saklı yordamlar hakkında bilgi almak için sorgular.Kullanıcılar, yalnızca bu Web yöntem, depolanan yordamlar izinleri gereklidir.Daha fazla bilgi için bkz:Web'e SQL paylaşılan açıklamanızı.