ALTER ENDPOINT (Transact-SQL)

  • Artikel

Berlaku untuk:SQL Server

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 MENGUBAH TITIK AKHIR. 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 di SQL Server 2012 (11.x).

Konvensi sintaks transact-SQL

Sintaksis

  
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 (12.x) dan versi 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.

Login 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 ENDPOINT 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 saat database berada dalam tingkat kompatibilitas 90 atau 100. (Tidak disarankan.) Gunakan algoritma yang lebih baru seperti salah satu algoritma AES sebagai gantinya. Di 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. Tetapi 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 MENGUBAH OTORISASI (Transact-SQL).

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

Lihat Juga

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