Aracılığıyla paylaş

  • Makale

ALTER bitiş NOKTASı (Transact-SQL)

Varolan bir bitiş noktası, aşağıdaki yollarla değiştirme etkinleştirir:

  • Varolan bir son nokta için yeni bir yöntem ekleyerek.

  • Değiştirme veya varolan yöntem, son nokta siliniyor.

  • Bir bitiş noktası özelliklerini değiştirerek.

Not

Bu konuda, sözdizimi ve ALTER son NOKTA için özel olan bağımsız değişkenler açıklanmaktadır.Bitiş NOKTASı, CREATE ve ALTER son NOKTA için ortak olan bağımsız değişkenler açıklamaları için bkz: (Transact-SQL) son NOKTA oluşturun.

Içinde SQL Server 2008Yerel XML Web Hizmetleri (SOAP/HTTP bitiş noktası) önerilmiyor. Daha fazla bilgi için bkz:Yerel XML Web Hizmetleri: SQL Server 2008 kullanım dışı..

Topic link iconTransact-SQL sözdizimi kuralları

ALTER ENDPOINT endPointName
[ STATE = { STARTED | STOPPED | DISABLED } ]
[ AS { TCP | HTTP } ( <protocol_specific_items> ) ]
[ FOR { SOAP | TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
   <language_specific_items>
        ) ]

<AS HTTP_protocol_specific_arguments> ::=
AS HTTP (
  [ [ , ] PATH = 'url' ]
  [ [ , ] PORTS = ( { CLEAR | SSL } [ ,...n ] ) ]
  [ [ , ] SITE = { '*' | '+' | 'webSite' } , ]
  [ [ , ] CLEAR_PORT = clearPort ]
  [ [ , ] SSL_PORT = SSLPort ]
  [ [,] AUTHENTICATION = ( { BASIC | DIGEST | NTLM | KERBEROS | INTEGRATED } [ ,...n ] ) ]
  [ [ , ] AUTH_REALM = { 'realm' | NONE } ]
  [ [ , ] DEFAULT_LOGON_DOMAIN = { 'domain' | NONE } ]
  [ [ , ] COMPRESSION = { ENABLED | DISABLED } ]
)

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
  LISTENER_PORT = listenerPort
  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]
)

<FOR SOAP_language_specific_arguments> ::=
FOR SOAP (
  [ { ADD WEBMETHOD [ 'namespace' .] 'method_alias' 
    (   NAME = 'database.owner.name'
      [ , SCHEMA = {NONE | STANDARD | DEFAULT } ]
      [ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY | NONE} ]
    )  
  } [ ,...n ] 
  ]

  [ { ALTER WEBMETHOD [ 'namespace' .] 'method_alias' 
    (   NAME = 'database.owner.name'
      [ , SCHEMA = {NONE | STANDARD | DEFAULT} ]
      [ , FORMAT = { ALL_RESULTS | ROWSETS_ONLY } ]
    )  
  } [ ,...n] 
]
  [ [ , ] { DROP WEBMETHOD [ 'namespace' .] 'method_alias' } [ ,...n ] ]
  [ [ , ] BATCHES = { ENABLED | DISABLED } ]
  [ [ , ] WSDL = { NONE | DEFAULT | 'sp_name' } ]
  [ [ , ] SESSIONS = { ENABLED | DISABLED } ]
  [ [ , ] LOGIN_TYPE = { MIXED | WINDOWS } ]
  [ [ , ] SESSION_TIMEOUT = timeoutInterval ]
  [ [ , ] DATABASE = { 'database_name' | DEFAULT } ]
  [ [ , ] NAMESPACE = { 'namespace' | DEFAULT } ]
  [ [ , ] SCHEMA = { NONE | STANDARD } ]
  [ [ , ] CHARACTER_SET = { SQL | XML } ]
  [ [ , ] HEADER_LIMIT = int ]
)

<FOR SERVICE_BROKER_language_specific_arguments> ::=
FOR SERVICE_BROKER (
   [ AUTHENTICATION = { 
      WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
      | CERTIFICATE certificate_name 
      | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name 
      | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] 
    } ]
   [ , ENCRYPTION = { DISABLED 
       | 
         {{SUPPORTED | REQUIRED } 
       [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] } 
   ]

  [ , MESSAGE_FORWARDING = {ENABLED | DISABLED} ]
  [ , MESSAGE_FORWARD_SIZE = forwardSize
)

<FOR DATABASE_MIRRORING_language_specific_arguments> ::=
FOR DATABASE_MIRRORING (
   [ AUTHENTICATION = { 
      WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ]
      | CERTIFICATE certificate_name 
      | WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] CERTIFICATE certificate_name 
      | CERTIFICATE certificate_name WINDOWS [ { NTLM | KERBEROS | NEGOTIATE } ] 
    } ]
   [ , ENCRYPTION = { DISABLED 
       | 
         {{SUPPORTED | REQUIRED } 
       [ ALGORITHM { RC4 | AES | AES RC4 | RC4 AES } ] } 
    ] 
   [ , ] ROLE = { WITNESS | PARTNER | ALL }
)

Bağımsız değişkenler

Not

Aşağıdaki bağımsız değişkenlere, son NOKTA için ALTER özgüdür.Diğer bağımsız değişkenleri açıklamaları için bkz: (Transact-SQL) son NOKTA oluşturun.

  • EKLENTİ webmethod
    Yeni bir yöntem bitiş noktası ekler.

    Important noteImportant Note:

    ADD WEBMETHOD yöntemleri duyurmak için kullandığınızda, birden fazla ise emin olmalısınız SQL Server Veritabanı adı örtüştüğü değil ortaya aynı HTTP Bitiş tarafından hizmet verilen. Bunu önlemek için Ad yolunun bir parçası olarak kayıtlı etki alanı adı URL'NIZIN ekleme göz önünde bulundurun.

  • webmethod DEĞİŞTİRME
    Varolan yöntem bitiş noktası tanımını değiştirir.

  • İLERLEDİKÇE {tcp | http}
    Aktarım protokol ile son NOKTA ALTER değiştiremezsiniz.

  • login yetkilendirme
    Bitiş NOKTASı ALTER yetkilendirme seçeneği kullanılamaz.Sahipliği, bitiş noktası oluşturulduğunda, yalnızca atanabilir.

  • webmethod BIRAK
    Varolan yöntem son nokta yok sayar.

  • İÇİN {soap | tsql | service_broker | database_mirroring}
    Yük türü ALTER son NOKTA ile değiştiremezsiniz.

Remarks

ALTER bitiş NOKTASı'nı kullandığınızda, yalnızca sahibin meşru olarak güncelleştirmek istediğiniz parametreleri belirtin.Varolan bir son nokta tüm özelliklerini açıkça bunları değiştirmedikçe aynı kalır.

Bitiş NOKTASı DDL) deyimleri içinde kullanıcı işlem yürütülemiyor.

Son nokta ile kullanmak için bir şifreleme algoritmasını seçme hakkında bilgi için bkz: Bir şifreleme algoritması seçme.

Not

RC4 görece zayıf bir algoritma ve AES oldukça güçlü bir algoritma.Ancak, AES RC4 ' çok daha yavaş gerçekleşiyor.Güvenlik, hızından daha yüksek öncelikli, AES kullanmanızı öneririz.

İzinler

Kullanıcı, sysadmin sabit sunucu rolü sahibi, bitiş noktası bir üyesi olmanız gerekir veya ALTER ANY bitiş NOKTASı izninin verilmiş olması gerekir.

Varolan bir son nokta sahipliğini değiştirmek için , ALTER yetkilendirme deyimini kullanmanız gerekir.Daha fazla bilgi için bkz:ALTER yetkilendirme (Transact-SQL).

Daha fazla bilgi için bkz:Endpoint IZINLERI (Transact-SQL).

Örnekler

C.Yeni bir yöntem için varolan bir son nokta ekleme...

Aşağıdaki örnek, yeni yöntem için önceden oluşturulmuş bitiş noktası ekler. sql_endpoint.

ALTER ENDPOINT sql_endpoint
FOR SOAP
(
  ADD WEBMETHOD 'SayHello' (name='AdventureWorks.dbo.SayHello')
);

b.RAW SOAP modunda işleyen yeni bir yöntem ekleme

Aşağıdaki örnek, yeni yöntem ekler. ReportUsageStats Belirtilen RAW modunda çalışır FORMAT=NONE, saklı yordam sonuçlar teslim etmek için olduğu gibi SOAP istemcilerine.Daha fazla bilgi için FORMAT seçeneği açıklamasına bakın... (Transact-SQL) son NOKTA oluşturun.

ALTER ENDPOINT sql_endpoint
FOR SOAP
(
  ADD WEBMETHOD 'ReportUsageStats' (name='myDatabase.dbo.sp_reportserverstats', FORMAT=NONE)
);

Değişiklik Geçmişi

Güncelleştirilmiş içerik

Izin verilen ek işlemleri belirtmek için bağımsız değişkenleri bölümü güncelleştirildi.