ALTER ENDPOINT (Transact-SQL)

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

Artikel ini menguraikan sintaks dan argumen yang khusus untuk ALTER ENDPOINT. Untuk deskripsi argumen yang umum untuk keduanya CREATE ENDPOINT dan ALTER ENDPOINT, lihat MEMBUAT TITIK AKHIR.

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

Konvensi sintaks transact-SQL

Sintaks

ALTER ENDPOINT endPointName [ AUTHORIZATION login ]
[ STATE = { STARTED | STOPPED | DISABLED } ]
[ AS { TCP } (
    <protocol_specific_arguments>
) ]
[ FOR { TSQL | SERVICE_BROKER | DATABASE_MIRRORING } (
    <language_specific_arguments>
) ]

<AS TCP_protocol_specific_arguments> ::=
AS TCP (
    LISTENER_PORT = listenerPort
    [ [ , ] LISTENER_IP = ALL | ( four_part_ipv4_address ) | ( 'ip_address_v6' ) ]
)

<FOR TSQL_language_specific_arguments> ::=
FOR TSQL (
    [ ENCRYPTION = { NEGOTIATED | STRICT } ]
)

<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 { AES | RC4 | AES RC4 | RC4 AES } ]
    } ]
    [ [ , ] MESSAGE_FORWARDING = { ENABLED | DISABLED } ]
    [ [ , ] MESSAGE_FORWARD_SIZE = forward_size ]
)

<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 { AES | RC4 | AES RC4 | RC4 AES } ]
    } ]
    [ , ] ROLE = { WITNESS | PARTNER | ALL }
)

Argumen

Argumen berikut khusus untuk ALTER ENDPOINT. Untuk deskripsi argumen yang tersisa, lihat CREATE ENDPOINT.

AS { TCP }

Anda tidak dapat mengubah protokol transportasi dengan ALTER ENDPOINT.

Login OTORISASI

Opsi AUTHORIZATION 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 ENDPOINT DDL tidak dapat dijalankan di dalam transaksi pengguna.

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

Algoritma RC4 yang tidak digunakan lagi

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.

Izin

Memerlukan keanggotaan dalam peran server tetap sysadmin , pemilik titik akhir, atau ALTER ANY ENDPOINT izin.

Untuk mengubah kepemilikan titik akhir yang ada, Anda harus menggunakan pernyataan tersebut ALTER AUTHORIZATION . Untuk informasi selengkapnya, lihat MENGUBAH OTORISASI.

Untuk informasi selengkapnya, lihat IZIN GRANT Endpoint.