Opsi Sambungan

Unduh driver PHP

Topik ini mencantumkan opsi yang diizinkan dalam array asosiatif (saat menggunakan sqlsrv_connect di driver SQLSRV) atau kata kunci yang diizinkan dalam nama sumber data (dsn) (saat menggunakan PDO::__construct di driver PDO_SQLSRV).

Tabel Opsi Koneksi ion

Tombol	Nilai	Deskripsi	Default
AccessToken	String	String byte token akses Microsoft Entra yang diekstrak dari respons OAuth JSON. string koneksi tidak boleh berisi ID pengguna, kata sandi, atau Authentication kata kunci. Untuk informasi selengkapnya, lihat Koneksi Menggunakan autentikasi Microsoft Entra	Tidak diatur.
APLIKASI	String	Menentukan nama aplikasi yang digunakan dalam pelacakan.	Tidak diatur.
ApplicationIntent	String	Menyatakan jenis beban kerja aplikasi saat menyambungkan ke server. Nilai yang mungkin adalah ReadOnly dan ReadWrite. Untuk informasi selengkapnya tentang Driver Microsoft untuk PHP untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan untuk Ketersediaan Tinggi, Pemulihan Bencana.	ReadWrite
AttachDBFileName	String	Menentukan file database mana yang harus dilampirkan server.	Tidak diatur.
Autentikasi	Salah satu string berikut: SqlPassword ActiveDirectoryPassword ActiveDirectoryMsi ActiveDirectoryServicePrincipal	Menentukan mode autentikasi. Untuk informasi selengkapnya, lihat Koneksi Menggunakan autentikasi Microsoft Entra	Tidak diatur.
CharacterSet (tidak didukung di driver PDO_SQLSRV)	String	Menentukan kumpulan karakter yang digunakan untuk mengirim data ke server. Nilai yang mungkin SQLSRV_ENC_CHAR dan UTF-8. Untuk informasi selengkapnya, lihat Cara: Mengirim dan Mengambil Data UTF-8 menggunakan Dukungan UTF-8 Bawaan.	SQLSRV_ENC_CHAR
ColumnEncryption	Salah satu string berikut: Diaktifkan Nonaktif String yang mengidentifikasi protokol pengesahan dan URL untuk membuktikan enklave	Menentukan apakah fitur Always Encrypted diaktifkan atau tidak. Jika protokol pengesahan dan URL ditentukan, Always Encrypted dengan enklave aman diaktifkan, asalkan persyaratan lain terpenuhi seperti yang dijelaskan di sini.	Nonaktif
Koneksi ionPooling	1 atau benar untuk kumpulan koneksi aktif. 0 atau salah untuk koneksi yang dinonaktifkan.	Menentukan apakah koneksi ditetapkan dari kumpulan koneksi (1 atau benar) atau tidak (0 atau salah).1	true (1)
Koneksi RetryCount	Bilangan bulat antara 0 dan 255 (inklusif)	Jumlah maksimum upaya untuk membangun kembali koneksi yang rusak sebelum menyerah. Secara default, satu upaya dilakukan untuk membangun kembali koneksi saat rusak. Nilai 0 berarti tidak ada koneksi ulang yang akan dicoba.	1
Koneksi RetryInterval	Bilangan bulat antara 1 dan 60 (inklusif)	Waktu, dalam detik, antara upaya untuk membangun kembali koneksi. Aplikasi akan mencoba untuk terhubung kembali segera setelah mendeteksi koneksi yang rusak, dan kemudian akan menunggu ConnectRetryInterval detik sebelum mencoba lagi. Kata kunci ini diabaikan jika ConnectRetryCount sama dengan 0.	10
Database	String	Menentukan nama database yang digunakan untuk koneksi yang sedang dibuat2.	Database default untuk login yang digunakan.
DecimalPlaces (tidak didukung di driver PDO_SQLSRV)	Bilangan bulat antara 0 dan 4 (inklusif)	Menentukan tempat desimal saat memformat nilai uang yang diambil. Opsi ini hanya berfungsi jika FormatDecimals benar. Bilangan bulat atau nilai negatif apa pun lebih dari 4 akan diabaikan.	Presisi dan skala default
Driver	String	Menentukan driver Microsoft ODBC yang digunakan untuk berkomunikasi dengan SQL Server. Kemungkinan nilai adalah: Odbc Driver 18 untuk SQL Server Driver ODBC 17 untuk SQL Server Driver ODBC 13 untuk SQL Server Odbc Driver 11 untuk SQL Server (hanya Windows).	Ketika kata kunci Driver tidak ditentukan, Driver Microsoft untuk PHP untuk SQL Server mencoba menemukan driver Odbc Microsoft yang didukung dalam sistem, dimulai dengan versi terbaru ODBC dan sebagainya.
Enkripsi	1 atau benar untuk enkripsi aktif. 0 atau false untuk enkripsi nonaktif.	Menentukan apakah komunikasi dengan SQL Server dienkripsi (1 atau benar) atau tidak terenkripsi (0 atau salah)3.	false (0)
Failover_Partner	String	Menentukan server dan instans cermin database (jika diaktifkan dan dikonfigurasi) untuk digunakan saat server utama tidak tersedia. Ada batasan untuk digunakan Failover_Partner dengan MultiSubnetFailover. Untuk informasi selengkapnya, lihat Dukungan untuk Ketersediaan Tinggi, Pemulihan Bencana. Opsi ini tidak didukung di Linux atau macOS karena pencerminan database tidak didukung oleh driver ODBC di Linux atau macOS. Sebagai gantinya, gunakan grup ketersediaan AlwaysOn dan atur MultiSubnetFailover opsi dan TransparentNetworkIPResolution .	Tidak diatur.
FormatDecimals (tidak didukung di driver PDO_SQLSRV)	1 atau true untuk memformat string desimal yang diambil. 0 atau false untuk perilaku pemformatan desimal default.	Menentukan apakah akan menambahkan nol di depan ke string desimal jika sesuai dan mengaktifkan DecimalPlaces opsi untuk memformat jenis uang. Jika dibiarkan false, perilaku default mengembalikan presisi yang tepat dan menghilangkan nol di depan untuk nilai kurang dari 1 digunakan. Untuk informasi selengkapnya, lihat Memformat String Desimal dan Nilai Uang.	false (0)
KeyStoreAuthentication	KeyVaultPassword KeyVaultClientSecret	Metode autentikasi untuk mengakses Azure Key Vault. Mengontrol jenis kredensial apa yang digunakan dengan KeyStorePrincipalId dan KeyStoreSecret. Untuk informasi selengkapnya, lihat Menggunakan Azure Key Vault.	Tidak diatur.
KeyStorePrincipalId	String	Pengidentifikasi untuk akun yang ingin mengakses Azure Key Vault. Jika KeyStoreAuthentication adalah KeyVaultPassword, nilai ini harus berupa nama pengguna Microsoft Entra. Jika KeyStoreAuthentication keyVaultClientSecret, nilai ini harus berupa ID klien aplikasi.	Tidak diatur.
KeyStoreSecret	String	Rahasia kredensial untuk akun yang ingin mengakses Azure Key Vault. Jika KeyStoreAuthentication adalah KeyVaultPassword, nilai ini harus berupa kata sandi Microsoft Entra. Jika KeyStoreAuthentication adalah KeyVaultClientSecret, nilai ini harus menjadi rahasia klien aplikasi.	Tidak diatur.
Bahasa	String	Menentukan bahasa pesan yang dikembalikan oleh server. Bahasa yang tersedia tercantum dalam sys.syslanguages tabel. Opsi ini tidak memengaruhi bahasa yang digunakan oleh driver itu sendiri, karena saat ini hanya tersedia dalam bahasa Inggris, dan tidak memengaruhi bahasa driver ODBC yang mendasarinya, yang bahasanya ditentukan oleh versi yang dilokalkan yang diinstal pada sistem klien. Oleh karena itu, mengubah pengaturan ini dapat mengakibatkan pesan dikembalikan dalam bahasa yang berbeda, tergantung pada apakah mereka berasal dari driver PHP, driver ODBC, atau SQL Server.	Defaultnya adalah bahasa yang diatur di SQL Server.
LoginTimeout	Bilangan bulat (driver SQLSRV) String (driver PDO_SQLSRV)	Menentukan jumlah detik untuk menunggu sebelum gagal dalam upaya koneksi.	Tidak ada batas waktu.
MultipleActiveResultSets	1 atau true untuk menggunakan beberapa tataan hasil aktif. 0 atau false untuk menonaktifkan beberapa kumpulan hasil aktif.	Menonaktifkan atau secara eksplisit memungkinkan dukungan untuk beberapa kumpulan hasil aktif (MARS). Untuk informasi selengkapnya, lihat Cara: Menonaktifkan Beberapa Kumpulan Hasil Aktif (MARS).	true (1)
MultiSubnetFailover	String	Selalu tentukan multiSubnetFailover=yes saat menyambungkan ke pendengar grup ketersediaan grup ketersediaan SQL Server 2012 (11.x) grup ketersediaan atau Instans Kluster Failover SQL Server 2012 (11.x). multiSubnetFailover=yes mengonfigurasi Driver Microsoft untuk PHP untuk SQL Server untuk memberikan deteksi dan koneksi yang lebih cepat ke server aktif (saat ini). Nilai yang mungkin adalah Ya dan Tidak. Untuk informasi selengkapnya tentang Driver Microsoft untuk PHP untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan untuk Ketersediaan Tinggi, Pemulihan Bencana.	Tidak
PWD (tidak didukung di driver PDO_SQLSRV)	String	Menentukan kata sandi yang terkait dengan ID Pengguna yang akan digunakan saat menyambungkan dengan SQL Server Authentication4.	Tidak diatur.
QuotedId	1 atau true untuk menggunakan aturan SQL-92. 0 atau salah untuk menggunakan aturan warisan.	Menentukan apakah akan menggunakan aturan SQL-92 untuk pengidentifikasi yang dikutip (1 atau benar) atau menggunakan aturan Transact-SQL warisan (0 atau salah).	true (1)
ReturnDatesAsStrings (tidak didukung di driver PDO_SQLSRV)	1 atau true untuk mengembalikan jenis tanggal dan waktu sebagai string. 0 atau false untuk mengembalikan jenis tanggal dan waktu sebagai jenis DateTime PHP.	Mengambil jenis tanggal dan waktu (datetime, smalldatetime, date, time, datetime2, dan datetimeoffset) sebagai string atau sebagai jenis PHP. Untuk informasi selengkapnya, lihat Cara: Mengambil Jenis Tanggal dan Waktu sebagai String Menggunakan Driver SQLSRV. Saat menggunakan driver PDO_SQLSRV, tanggal dikembalikan sebagai string kecuali ditentukan lain. Untuk informasi selengkapnya, lihat Cara: Mengambil Jenis Tanggal dan Waktu sebagai Objek DateTime PHP Menggunakan Driver PDO_SQLSRV.	salah
Digulir	String	"buffered" menunjukkan bahwa Anda menginginkan kursor sisi klien (buffered), yang memungkinkan Anda untuk menyimpan seluruh hasil yang diatur dalam memori. Untuk informasi selengkapnya, lihat Jenis Kursor (Driver SQLSRV).	Kursor hanya penerusan
Server (tidak didukung di driver SQLSRV)	String	Instans SQL Server yang akan disambungkan. Anda juga dapat menentukan nama jaringan virtual, untuk menyambungkan ke grup ketersediaan AlwaysOn. Untuk informasi selengkapnya tentang Driver Microsoft untuk PHP untuk dukungan SQL Server untuk grup ketersediaan AlwaysOn, lihat Dukungan untuk Ketersediaan Tinggi, Pemulihan Bencana.	Server adalah kata kunci yang diperlukan (meskipun tidak harus menjadi kata kunci pertama dalam string koneksi). Jika nama server tidak diteruskan ke kata kunci, upaya dilakukan untuk menyambungkan ke instans lokal. Nilai yang diteruskan ke Server dapat menjadi nama instans SQL Server, atau alamat IP instans. Anda dapat secara opsional menentukan nomor port (misalnya, sqlsrv:server=(local),1033). Mulai versi 3.0 dari Microsoft Drivers untuk PHP untuk SQL Server Anda juga dapat menentukan instans LocalDB dengan server=(localdb)\instancename. Untuk informasi selengkapnya, lihat Dukungan untuk LocalDB.
TraceFile	String	Menentukan jalur untuk file yang digunakan untuk melacak data.	Tidak diatur.
TraceOn	1 atau true untuk mengaktifkan pelacakan. 0 atau false untuk menonaktifkan pelacakan.	Menentukan apakah pelacakan ODBC diaktifkan (1 atau benar) atau dinonaktifkan (0 atau salah) untuk koneksi yang dibuat.	false (0)
TransactionIsolation	Driver SQLSRV menggunakan nilai berikut: SQLSRV_TXN_READ_UNCOMMITTED SQLSRV_TXN_READ_COMMITTED SQLSRV_TXN_REPEATABLE_READ SQLSRV_TXN_SNAPSHOT SQLSRV_TXN_SERIALIZABLE Driver PDO_SQLSRV menggunakan nilai berikut: PDO::SQLSRV_TXN_READ_UNCOMMITTED PDO::SQLSRV_TXN_READ_COMMITTED PDO::SQLSRV_TXN_REPEATABLE_READ PDO::SQLSRV_TXN_SNAPSHOT PDO::SQLSRV_TXN_SERIALIZABLE	Menentukan tingkat isolasi transaksi. Untuk informasi selengkapnya tentang isolasi transaksi, lihat MENGATUR TINGKAT ISOLASI TRANSAKSI dalam dokumentasi SQL Server.	SQLSRV_TXN_READ_COMMITTED atau PDO::SQLSRV_TXN_READ_COMMITTED
TransparentNetworkIPResolution	Diaktifkan atau Dinonaktifkan	Mempengaruhi urutan koneksi ketika IP pertama yang diselesaikan dari nama host tidak merespons dan ada beberapa IP yang terkait dengan nama host. Ini berinteraksi dengan MultiSubnetFailover untuk menyediakan urutan koneksi yang berbeda. Untuk informasi selengkapnya, lihat Resolusi IP Jaringan Transparan atau Menggunakan Resolusi IP Jaringan Transparan.	Diaktifkan
TrustServerCertificate	1 atau benar untuk mempercayai sertifikat. 0 atau salah untuk tidak mempercayai sertifikat.	Menentukan apakah klien harus mempercayai (1 atau benar) atau menolak (0 atau salah) sertifikat server yang ditandatangani sendiri.	false (0)
UID (tidak didukung di driver PDO_SQLSRV)	String	Menentukan ID Pengguna yang akan digunakan saat menyambungkan dengan AutentikasiSQL Server 4.	Tidak diatur.
WSID	String	Menentukan nama komputer untuk pelacakan.	Tidak diatur.

1. Atribut ConnectionPooling tidak dapat digunakan untuk mengaktifkan/menonaktifkan pengumpulan koneksi di Linux dan macOS. Lihat Koneksi ion Pooling (Driver Microsoft untuk PHP untuk SQL Server).

2. Semua kueri yang dijalankan pada koneksi yang dibuat dibuat ke database yang ditentukan oleh Database atribut . Namun, jika pengguna memiliki izin yang sesuai, data di database lain dapat diakses dengan menggunakan nama yang sepenuhnya memenuhi syarat. Misalnya, jika database master diatur dengan Database atribut koneksi, masih dimungkinkan untuk menjalankan kueri Transact-SQL yang mengakses tabel AdventureWorks.HumanResources.Employee dengan menggunakan nama yang sepenuhnya memenuhi syarat.

3. Mengaktifkan Encryption dapat memengaruhi performa beberapa aplikasi karena overhead komputasi yang diperlukan untuk mengenkripsi data.

4. Atribut UID dan PWD keduanya harus diatur saat menyambungkan dengan Autentikasi SQL Server.

Banyak kunci yang didukung adalah atribut ODBC string koneksi. Untuk informasi tentang string koneksi ODBC, lihat Menggunakan Kata Kunci String Koneksi ion dengan SQL Native Client.

Lihat Juga

Koneksi ke Server