ALTER ENDPOINT (Transact-SQL)

Berlaku untuk: SQL Server (semua versi yang didukung)

Mengaktifkan modifikasi titik akhir yang sudah ada dengan cara berikut:

  • Dengan menambahkan metode baru ke titik akhir yang sudah ada.

  • Dengan memodifikasi atau menghilangkan metode yang ada dari titik akhir.

  • Dengan mengubah properti titik akhir.

Catatan

Topik ini menguraikan sintaks dan argumen yang khusus untuk ALTER ENDPOINT. Untuk deskripsi argumen yang umum untuk CREATE ENDPOINT dan ALTER ENDPOINT, lihat CREATE ENDPOINT (Transact-SQL).

Native XML Web Services (titik akhir SOAP/HTTP) dihapus dimulai pada SQL Server 2012 (11.x).

Ikon tautan topikKonvensi Sintaks Transact-SQL

Sintaks

  
ALTER ENDPOINT endPointName [ AUTHORIZATION login ]  
[ STATE = { STARTED | STOPPED | DISABLED } ]  
[ AS { TCP } ( <protocol_specific_items> ) ]  
[ FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (  
   <language_specific_items>  
        ) ]  
  
<AS TCP_protocol_specific_arguments> ::=  
AS TCP (  
  LISTENER_PORT = listenerPort  
  [ [ , ] LISTENER_IP = ALL | ( 4-part-ip ) | ( "ip_address_v6" ) ]  
)  
<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 }  
)  
  

Catatan

Untuk melihat sintaks Transact-SQL untuk SQL Server 2014 dan yang lebih lama, lihat Dokumentasi versi sebelumnya.

Argumen

Catatan

Argumen berikut khusus untuk ALTER ENDPOINT. Untuk deskripsi argumen yang tersisa, lihat CREATE ENDPOINT (Transact-SQL).

AS { TCP }
Anda tidak dapat mengubah protokol transportasi dengan ALTER ENDPOINT.

Masuk OTORISASI
Opsi OTORISASI tidak tersedia di ALTER ENDPOINT. Kepemilikan hanya dapat ditetapkan saat titik akhir dibuat.

UNTUK { TSQL | SERVICE_BROKER | DATABASE_MIRRORING }
Anda tidak dapat mengubah jenis payload dengan ALTER ENDPOINT.

Keterangan

Saat Anda menggunakan ALTER ENDPOINT, tentukan hanya parameter yang ingin Anda perbarui. Semua properti titik akhir yang ada tetap sama kecuali Anda secara eksplisit mengubahnya.

Pernyataan DDL TITIK AKHIR tidak dapat dijalankan di dalam transaksi pengguna.

Untuk informasi tentang memilih algoritma enkripsi untuk digunakan dengan titik akhir, lihat Memilih Algoritma Enkripsi.

Catatan

Algoritma RC4 hanya didukung untuk kompatibilitas mundur. Materi baru hanya dapat dienkripsi menggunakan RC4 atau RC4_128 ketika database berada dalam tingkat kompatibilitas 90 atau 100. (Tidak disarankan.) Gunakan algoritma yang lebih baru seperti salah satu algoritma AES sebagai gantinya. Dalam SQL Server 2012 (11.x) dan versi yang lebih baru, materi yang dienkripsi menggunakan RC4 atau RC4_128 dapat didekripsi dalam tingkat kompatibilitas apa pun.

RC4 adalah algoritma yang relatif lemah, dan AES adalah algoritma yang relatif kuat. Tapi AES jauh lebih lambat daripada RC4. Jika keamanan adalah prioritas yang lebih tinggi untuk Anda daripada kecepatan, kami sarankan Anda menggunakan AES.

Izin

Pengguna harus menjadi anggota peran server tetap sysadmin , pemilik titik akhir, atau telah diberikan izin ALTER ANY ENDPOINT.

Untuk mengubah kepemilikan titik akhir yang ada, Anda harus menggunakan pernyataan ALTER AUTHORIZATION. Untuk informasi selengkapnya, lihat ALTER AUTHORIZATION (Transact-SQL).

Untuk informasi selengkapnya, lihat GRANT Endpoint Permissions (Transact-SQL).

Lihat juga

DROP ENDPOINT (Transact-SQL)
EVENTDATA (Transact-SQL)