Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Adaptor Microsoft BizTalk untuk URI koneksi SQL Server berisi properti yang digunakan adaptor untuk membuat koneksi ke database SQL Server. Topik ini menyediakan informasi tentang URI koneksi SQL Server, dan menyediakan tautan ke topik lain yang menjelaskan cara menentukan URI dalam skenario pemrograman yang berbeda.
URI Koneksi untuk Adaptor SQL
URI alamat titik akhir umum di WCF diwakili sebagai: scheme://hostinfoparams?query_string, di mana:
skema adalah nama skema.
hostinfoparams adalah informasi yang diperlukan untuk membuat koneksi ke host; misalnya, nama server.
query_string adalah kumpulan nilai nama opsional dari parameter yang dibatasi oleh tanda tanya (?).
URI koneksi adaptor SQL mematuhi format dasar ini dan diimplementasikan sebagai berikut:
mssql://[Server_Name[:Portno]]/[Database_Instance_Name]/[Database_Name]?FailoverPartner=[Partner_Server_Name]&InboundId=[Inbound_ID]
di mana, mssql adalah skema untuk URI koneksi SQL Server.
Tabel berikut menjelaskan properti yang terkandung dalam URI koneksi.
| Properti URI dari Koneksi | Kategori | Deskripsi |
|---|---|---|
| [SERVER_NAME] | hostinfoparams | Nama server tempat SQL Server diinstal. Jika Anda tidak menentukan nilai, adaptor mengasumsikan nama server sebagai "localhost" dan membuat koneksi dengan database SQL Server di server lokal. |
| [PORTNO] | hostinfoparams | Nomor port tempat koneksi dibuat. Jika Anda tidak menentukan nilai, adaptor akan tersambung melalui port default. |
| [DATABASE_INSTANCE_NAME] | hostinfoparams | Nama instans SQL Server yang akan disambungkan. Jika Anda tidak menentukan nilai, adaptor akan tersambung ke instans database default. |
| [DATABASE_NAME] | hostinfoparams | Nama database yang akan disambungkan. Jika Anda tidak menentukan nilai, adaptor akan tersambung ke database default. |
| [PARTNER_SERVER_NAME] | query_string | Nama database SQL Server failover untuk disambungkan jika database SQL Server utama tidak tersedia. Untuk informasi selengkapnya tentang ketersediaan tinggi sehubungan dengan SQL Server, lihat Pencerminan Database di SQL Server. |
| [INBOUND_ID] | query_string | Pengidentifikasi yang Anda tambahkan ke URI koneksi untuk membuatnya unik. Anda harus menyediakan parameter koneksi ini jika Anda ingin menghasilkan metadata untuk operasi masuk TypedPolling . Selain itu, dalam aplikasi BizTalk, jika Anda memiliki beberapa lokasi penerima polling database yang sama, ID masuk membuat URI koneksi unik, sehingga memungkinkan klien adaptor untuk menerima pesan polling dari database yang sama di lokasi penerima yang berbeda. Untuk informasi lebih lanjut, lihat Menerima Pesan Polling Melalui Beberapa Port Penerima menggunakan SQL dengan BizTalk Server. |
Nota
Untuk informasi selengkapnya tentang properti string koneksi ini, lihat Properti SqlConnection.ConnectionString.
Kredensial SQL Server dan URI Koneksi
Adaptor SQL tidak mendukung menentukan kredensial dalam URI koneksi. Untuk informasi selengkapnya tentang menentukan kredensial dalam aplikasi Anda yang menggunakan adaptor SQL, lihat Mengamankan aplikasi SQL Anda.
Menggunakan Karakter Khusus di URI Koneksi
Adaptor SQL tidak mendukung penentuan URI koneksi yang memiliki karakter khusus untuk salah satu nilai parameter. Jika nilai parameter koneksi berisi karakter khusus, pastikan Anda melakukan salah satu hal berikut:
Jika Anda menentukan URI di Visual Studio menggunakan Add Adapter Service Reference Plug-in atau Consume Adapter Service Add-in, Anda harus menentukannya as-is di tab Properti URI , yaitu, tanpa menggunakan karakter escape apa pun. Jika Anda menentukan URI langsung di bidang Konfigurasi URI dan parameter koneksi berisi karakter khusus, Anda harus menentukan parameter koneksi menggunakan karakter escape yang tepat.
Misalnya, jika URI koneksi memiliki parameter dengan nama
sql server, Anda harus menentukannya sebagaisql%20server.Jika Anda menentukan URI saat membuat port kirim atau terima di konsol Administrasi BizTalk Server, dan parameter koneksi berisi karakter khusus, Anda harus menentukan parameter koneksi menggunakan karakter escape yang tepat.
Menggunakan URI Koneksi untuk Menyambungkan ke Database SQL Server
Berikut ini adalah sampel URI koneksi untuk adaptor SQL.
mssql://sql_server/sql_server_instance//
Dalam contoh sebelumnya, "sql_server" adalah nama komputer tempat SQL Server diinstal sedangkan "sql_server_instance" adalah nama instans database yang akan disambungkan. Karena tidak ada nama database yang ditentukan, adaptor akan tersambung ke database default.
Berikut ini adalah contoh URI koneksi tempat database SQL Server diinstal pada komputer yang sama dengan adaptor SQL. Dalam contoh ini, adaptor tersambung ke database "my_database" untuk instans database "sql_server_instance" di komputer lokal.
mssql://localhost/sql_server_instance/my_database/
Dalam contoh ini, adaptor tersambung ke database default untuk instans default yang berjalan di komputer lokal.
mssql://localhost///
Untuk informasi tentang cara menentukan koneksi ke database SQL Server saat Anda:
Gunakan Add-in Proyek BizTalk Consume Adapter Service atau Add Adapter Service Reference Visual Studio Plug-in, lihat Menyambungkan ke SQL Server di Visual Studio menggunakan adaptor SQL.
Mengonfigurasi port kirim atau menerima port (lokasi) dalam solusi BizTalk Server, lihat Mengonfigurasi pengikatan port fisik secara manual ke adaptor SQL.
Gunakan model saluran WCF dalam solusi pemrograman, lihat Membuat saluran menggunakan adaptor SQL.
Gunakan model layanan WCF dalam solusi pemrograman, lihat Mengonfigurasi Pengikatan Klien untuk Adaptor SQL.