Properti string koneksi

Artikel
09/07/2023

Berlaku untuk: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Artikel ini menjelaskan properti string koneksi digunakan oleh aplikasi klien yang terhubung ke dan mengkueri Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS), dan model semantik Power BI Premium. Properti ini digunakan oleh pustaka klien Analysis Services, ADOMD.NET, AMO, dan penyedia OLE DB (MSOLAP) untuk Analysis Services. Sebagian besar properti string koneksi dapat digunakan dengan ketiga pustaka klien. Pengecualian dipanggil dalam deskripsi.

Gunakan pemilih Versi di atas daftar isi di sebelah kiri untuk melihat hanya properti yang berlaku untuk platform atau versi tertentu.

Properti koneksi

Sumber Data.

Menentukan instans server. Properti ini diperlukan untuk semua koneksi.

Nilai yang valid untuk Azure Analysis Services mencakup <protocol>://<region>/<servername> di mana protokol adalah string asazure atau link saat menggunakan alias nama server, wilayah adalah Uri tempat server dibuat (misalnya, westus.asazure.windows.net), dan nama server adalah nama server unik Anda di wilayah tersebut.

Contoh	Deskripsi
`Data source=asazure://westus.asazure.windows.net/myasserver`	Azure Analysis Services.
`Data source=link://friendlyname.salesapp.azurewebsites.net/`	Azure Analysis Services menggunakan alias nama server.

Nilai yang valid untuk Power BI Premium mencakup <protocol>://api.powerbi.com/v1.0/[tenant name]/[workspace name] di mana protokol adalah string powerbi, Uri adalah api.powerbi.com, nama penyewa adalah nama penyewa organisasi atau myorg, dan nama ruang kerja adalah nama ruang kerja yang ditetapkan untuk kapasitas khusus.

Contoh	Deskripsi
`Data source=powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace`	Power BI Premium ruang kerja.

Nilai yang valid untuk SQL Server Analysis Services mencakup nama jaringan atau alamat IP server, lokal atau localhost untuk koneksi lokal, URL jika server dikonfigurasi untuk akses HTTP atau HTTPS, atau nama file kubus lokal (.cub).

Contoh	Deskripsi
`Data source=AW-SRV01`	Instans dan port default SSAS (TCP 2383).
`Data source=AW-SRV01\Finance`	Instans bernama SSAS.
`Data source=AW-SRV01:8081`	Instans default SSAS, port yang ditentukan.
`Data source=AW-SRV01.corp.Adventure-Works.com`	Nama domain SSAS yang sepenuhnya memenuhi syarat, instans default, dan port.
`Data source=172.16.254.1`	Alamat IP SSAS server, melewati pencarian server DNS. Berguna untuk memecahkan masalah koneksi.

Penyedia

Properti ini diperlukan pada string koneksi saat menggunakan penyedia OLE DB seperti MSOLAP. Ini memungkinkan Anda untuk menggunakan penyedia independen versi (biasanya yang terbaru) seperti "Provider=MSOLAP", atau Anda juga dapat menentukan penyedia dependen versi seperti "Provider=MSOLAP.7". Nilai dependen versi yang valid mengikuti pola MSOLAP.<versi>, di mana <versinya> adalah 7 atau 8. Misalnya, MSOLAP.7 dirilis pada SQL Server 2016. Versi ".8" adalah yang terbaru dan dianggap "evergreen". Diharapkan untuk terus memperbarui dengan kompatibilitas mundur yang dipertahankan. Nomor versi sebelumnya juga dimungkinkan, tetapi rilis MSOLAP tersebut sekarang berada di luar dukungan standar.

Properti ini bersifat opsional untuk ADOMD.NET dan AMO. Ini diizinkan untuk kenyamanan saat menyalin string koneksi MSOLAP untuk digunakan dengan ADOMD.NET dan AMO.

Contoh	Deskripsi
`Provider=MSOLAP.7`	Connections memerlukan penyedia OLE DB versi OLE DB SQL Server 2016 untuk Analysis Services.

Kubus

Nama kubus atau nama perspektif. Database dapat berisi beberapa kubus dan perspektif. Ketika beberapa target dimungkinkan, sertakan kubus atau nama perspektif pada string koneksi.

Contoh	Deskripsi
`Cube=Sales`	Kubus bernama Sales.
`Cube=SalesPerspective`	Perspektif bernama SalesPerspective.

Properti autentikasi dan keamanan

Azure Analysis Services dan Power BI Premium menggunakan Microsoft Entra ID - Universal dengan MFA (disarankan), autentikasi Microsoft Entra dengan nama pengguna dan kata sandi, token akses Microsoft Entra, atau Windows Otentikasi.

SQL Server Analysis Services hanya menggunakan autentikasi Windows. Autentikasi dasar dan autentikasi anonim dapat digunakan jika akses HTTP diaktifkan melalui MSMDPUMP.dll, seperti yang dijelaskan dalam artikel Mengonfigurasi Akses HTTP ke Analysis Services di IIS 8.0. Lihat Langkah 3: Mengonfigurasi autentikasi IIS untuk detail tentang cara mengonfigurasi metode autentikasi yang didukung untuk Analysis Services melalui HTTP.

Properti tercantum dalam urutan alfabet.

EffectiveUserName

Gunakan saat identitas pengguna harus ditiru di server. Untuk SSAS, tentukan dalam format domain\pengguna. Untuk Azure AS dan Power BI Premium, tentukan dalam format UPN. Untuk menggunakan properti ini, pemanggil harus memiliki izin administratif di Analysis Services. Dalam Power BI Premium, penelepon harus menjadi admin ruang kerja tempat model semantik berada.

CustomData

Nilai string yang akan diteruskan ke mesin di string koneksi lalu diambil dengan menggunakan fungsi MDX CustomData() atau fungsi CUSTOMDATA() DAX. Paling umum digunakan untuk meneruskan userID atau nama pengguna sebagai nilai, lalu menentukan nilai tersebut dalam definisi ekspresi keamanan.

Enkripsi Kata Sandi

Menentukan apakah kata sandi lokal akan digunakan untuk mengenkripsi kubus lokal. Nilai yang valid adalah True atau False. Defaultnya adalah False.

Kata Sandi Enkripsi

Kata sandi yang digunakan untuk mendekripsi kubus lokal terenkripsi. Nilai default kosong. Nilai ini harus diatur secara eksplisit oleh pengguna.

Tingkat Peniruan

Menunjukkan tingkat peniruan bahwa server diizinkan untuk digunakan saat meniru klien. Nilai yang valid meliputi:

Anonim. Klien bersifat anonim dengan server. Proses server tidak dapat memperoleh informasi tentang klien, juga tidak dapat ditiru oleh klien.
Identifikasi. Proses server bisa mendapatkan identitas klien. Server dapat meniru identitas klien untuk tujuan otorisasi tetapi tidak dapat mengakses objek sistem sebagai klien.
Meniru. Ini adalah nilai default. Identitas klien dapat ditiru, tetapi hanya ketika koneksi dibuat, dan tidak pada setiap panggilan.
Delegasi. Proses server dapat meniru konteks keamanan klien saat bertindak atas nama klien. Proses server juga dapat melakukan panggilan keluar ke server lain sambil bertindak atas nama klien.

Keamanan Terintegrasi

Identitas Windows pemanggil digunakan untuk menyambungkan ke Analysis Services. Nilai yang valid adalah SSPI, kosong, Dasar, dan ClaimsToken*.

SSPI adalah nilai default untuk koneksi TCP, memungkinkan NTLM, Kerberos, atau autentikasi Anonim. Untuk Azure AS dan Power BI Premium, SSPI menunjukkan Terjemahan AD. Saat menggunakan SSPI, properti ProtectionLevel harus diatur ke Sambungkan, Integritas Pkt, atau Privasi Pkt.

kosong adalah nilai default untuk koneksi HTTP.

*ClaimsToken didukung untuk Azure AS dan Power BI Premium.

Pertahankan Info Keamanan

Nilai yang valid adalah True atau False. Ketika diatur ke True, informasi keamanan, seperti identitas pengguna atau kata sandi yang sebelumnya ditentukan pada string koneksi, dapat diperoleh dari koneksi setelah koneksi dibuat. Nilai defaultnya adalah False.

Tingkat Perlindungan

Menentukan tingkat keamanan yang digunakan pada koneksi. Nilai yang didukung bergantung pada transportasi yang mendasar. Nilai yang valid adalah:

Tidak ada. Koneksi tidak terauthentikasi atau anonim. Tidak melakukan autentikasi pada data yang dikirim ke server.
Sambungkan. Koneksi terautentikasi. Mengautentikasi hanya ketika klien membuat hubungan dengan server.
Integritas Pkt. Koneksi terenkripsi. Memverifikasi bahwa semua data diterima dari klien dan belum diubah saat transit.
Privasi Pkt. Enkripsi yang ditandatangani, hanya didukung untuk TCP. Memverifikasi bahwa semua data diterima dari klien, bahwa data belum diubah saat transit, dan melindungi privasi data dengan mengenkripsinya.

Untuk mempelajari selengkapnya, lihat Menetapkan Connections Aman di ADOMD.NET

Peran

Tentukan daftar peran yang telah ditentukan sebelumnya yang dibatasi koma untuk menyambungkan ke server atau database menggunakan izin yang disampaikan oleh peran tersebut. Jika properti ini dihilangkan, semua peran digunakan, dan izin yang efektif adalah kombinasi dari semua peran. Mengatur properti ke nilai kosong, misalnya, Roles=' ' berarti koneksi klien tidak memiliki keanggotaan peran.

Administrator yang menggunakan properti ini tersambung menggunakan izin yang disampaikan oleh peran. Beberapa perintah mungkin gagal jika peran tidak memberikan izin yang memadai.

Jika menentukan peran saat menyambungkan ke ruang kerja Power BI Premium, gunakan peran ruang kerja dari model keamanan Power BI.

SSPI

Secara eksplisit menentukan paket keamanan mana yang akan digunakan untuk autentikasi klien saat Integrated Security diatur ke SSPI. SSPI mendukung beberapa paket, tetapi Anda dapat menggunakan properti ini untuk menentukan paket tertentu. Nilai yang valid adalah:

Bernegosiasi
Kerberos
NTLM
Pengguna Anonim

Jika properti ini tidak diatur, semua paket akan tersedia untuk koneksi.

Gunakan Enkripsi untuk Data

Mengenkripsi transmisi data. Nilai yang valid adalah True atau False.

ID Pengguna=...; Kata sandi=

Properti ID Pengguna dan Kata Sandi menyediakan kredensial yang sesuai ke server ketika pengguna aktif saat ini di aplikasi klien tidak dapat disebarluaskan secara otomatis ke server. Perilaku tergantung pada protokol transportasi dan server yang terhubung ke:

Saat menyambungkan melalui TCP ke SSAS, pustaka klien akan meniru pengguna Windows menggunakan nama pengguna dan kata sandi yang ditentukan, lalu terhubung seperti biasa ke server.
Saat menyambungkan melalui HTTP ke SSAS, kredensial disediakan ke server web berdasarkan mode autentikasi yang dikonfigurasi di server web, misalnya autentikasi Dasar atau autentikasi Windows. Server web akan melakukan peniruan Windows yang sesuai sebelum menyambungkan ke server SSAS, oleh karena itu memberikan alur kredensial yang benar ke server.
Saat menyambungkan ke Azure AS atau Power BI Premium, ID Pengguna dan Kata Sandi digunakan untuk mendapatkan token Microsoft Entra yang kemudian disajikan ke layanan selama autentikasi. Microsoft Entra ID mungkin juga memerlukan autentikasi multifaktor (MFA), yang dapat memerlukan interaksi pengguna tambahan sebelum token dapat dihasilkan.
Jika Anda telah memperoleh token akses pembawa Microsoft Entra ID yang valid dari aplikasi Anda sendiri, Anda dapat mengatur properti AccessToken dari objek AdomdConnection sebelum membuat koneksi. Di properti AccessToken dari objek konektivitas yang relevan (AdomdConnection, Server, dll.), pastikan Anda mengatur token akses dan menentukan waktu kedaluwarsanya. Autentikasi didukung untuk token pembawa yang diperoleh secara interaktif untuk pengguna, dan dengan menggunakan alur On-Behalf-Of OAuth 2.0 (misalnya, aplikasi web tingkat menengah yang terhubung ke Analysis Services atas nama pengguna). Hilangkan jenis token saat meneruskan token akses di properti AccessToken . Pustaka klien Analysis Services secara otomatis menambahkan nilai auth-scheme "Bearer" ke token akses. Pastikan untuk mengingat hal-hal berikut:
- Microsoft Entra token akses pembawa memiliki masa pakai terbatas. Secara default, antara 60-90 menit. Jika aplikasi Anda melakukan operasi jangka panjang yang melebihi masa pakai token akses, Anda dapat menyediakan fungsi panggilan balik melalui properti OnAccessTokenExpired dari objek AdomdConnection untuk merefresh token akses saat token akses saat ini akan kedaluwarsa. Atau, Anda dapat memperbarui properti AccessToken secara langsung tanpa bantuan fungsi panggilan balik. Penggunaan fungsi panggilan balik disarankan untuk memastikan token akses di-refresh dalam masa pakai token akses saat ini.
- Menggunakan properti String koneksi Kata Sandi untuk meneruskan token akses tidak disarankan. Anda masih dapat menghilangkan properti ID Pengguna di string koneksi dan hanya menentukan token akses di properti Kata Sandi, tetapi dalam kasus tersebut token akses tidak dapat di-refresh. Gunakan properti AccessToken sebagai gantinya sehingga Anda dapat menyediakan token akses baru untuk koneksi yang ada saat diperlukan. Mengatur properti Kata Sandi dan properti AccessToken tidak didukung.

Catatan: "ID Pengguna" memiliki ruang yang disematkan. Alias alternatif untuk ID Pengguna adalah UID dan alias alternatif untuk Kata Sandi adalah PWD.

Properti tujuan khusus

Properti ini digunakan untuk memastikan perilaku koneksi tertentu yang diperlukan oleh aplikasi. Properti tercantum dalam urutan alfabet.

Nama Aplikasi

Mengatur nama aplikasi yang terkait dengan koneksi. Nilai ini dapat berguna saat memantau peristiwa pelacakan, terutama ketika Anda memiliki beberapa aplikasi yang mengakses database yang sama. Misalnya, menambahkan Nama Aplikasi='test' ke string koneksi menyebabkan 'pengujian' muncul dalam jejak SQL Server Profiler. Alias untuk properti ini termasuk SspropInitAppName, AppName. Untuk mempelajari selengkapnya, lihat Nama Aplikasi untuk SQL Server Connections.

Periode Sinkronisasi Otomatis

Mengatur frekuensi (dalam milidetik) sinkronisasi cache klien dan server. ADOMD.NET menyediakan penembolokan klien untuk objek yang sering digunakan yang memiliki overhead memori minimal. Ini membantu mengurangi jumlah perjalanan pulang pergi ke server. Defaultnya adalah 10.000 milidetik (atau 10 detik). Ketika diatur ke null atau 0, sinkronisasi otomatis dimatikan.

Untuk alasan performa, pustaka klien menyimpan beberapa informasi dari server, misalnya, kumpulan baris skema tertentu. Periode Sinkronisasi Otomatis memungkinkan pengguna untuk mengubah periode waktu setelah pustaka klien memeriksa dengan server apakah cache perlu dikosongkan atau tidak. Secara umum, Anda tidak perlu mengubah nilai dari default.

Pengodean Karakter

Menentukan bagaimana karakter dikodekan pada permintaan. Nilai yang valid adalah Default atau UTF-8 (ini setara), dan UTF-16.

CommitTimeout

Properti XMLA. Menentukan berapa lama, dalam milidetik, fase penerapan dari perintah yang sedang berjalan menunggu sebelum menggulung balik. Saat lebih besar dari 0, ambil alih nilai properti CommitTimeout yang sesuai dalam konfigurasi server.

CompareCaseSensitiveStringFlags

Menyesuaikan perbandingan string peka huruf besar/kecil untuk lokal tertentu.

Tingkat Pemadatan

Jika TransportCompression dikompresi , Anda dapat mengatur tingkat pemadatan untuk mengontrol berapa banyak kompresi yang digunakan. Nilai yang valid adalah 0 hingga 9, dengan 0 memiliki pemadatan paling sedikit, dan 9 memiliki pemadatan paling banyak. Peningkatan kompresi memperlambat performa. Nilai default adalah 0.

Waktu Habis Sambungkan

Menentukan jumlah waktu maksimum (dalam detik) klien mencoba koneksi sebelum waktu habis. Jika koneksi tidak berhasil dalam periode ini, klien berhenti mencoba menyambungkan dan menghasilkan kesalahan.

DbpropMsmdRequestMemoryLimit

Mengambil alih nilai properti server Memory\QueryMemoryLimit untuk koneksi.

Ditentukan dalam kilobyte, properti ini dapat mengurangi jumlah memori yang digunakan selama kueri dari memori maksimum yang diizinkan (ditentukan sebagai persentase) di QueryMemoryLimit. Ini tidak dapat meningkatkan jumlah memori yang digunakan di luar memori maksimum yang diizinkan yang ditentukan dalam QueryMemoryLimit.

Default MDX Visual Mode

Atur properti ini untuk mengontrol bagaimana anggota diagregasi saat keamanan dimensi diterapkan.

Untuk data kubus yang boleh dilihat semua orang, menggabungkan semua anggota masuk akal karena semua nilai yang berkontribusi pada total terlihat. Namun, jika Anda memfilter atau membatasi dimensi berdasarkan identitas pengguna, menampilkan total berdasarkan semua anggota (menggabungkan nilai yang dibatasi dan diizinkan ke dalam satu total) mungkin membingungkan atau menampilkan lebih banyak informasi daripada yang harus diungkapkan.

Untuk menentukan bagaimana anggota diagregasi saat keamanan dimensi diterapkan, Anda dapat mengatur properti ini ke True untuk hanya menggunakan nilai yang diizinkan dalam agregasi, atau False untuk mengecualikan nilai terbatas dari total.

Saat diatur pada string koneksi, nilai ini berlaku untuk tingkat kubus atau perspektif. Dalam model, Anda dapat mengontrol total visual pada tingkat yang lebih terperinci.

Nilai yang valid adalah,

0 adalah defaultnya. Saat ini, perilaku default setara dengan 2, di mana agregasi menyertakan nilai yang disembunyikan dari pengguna.
1 mengecualikan nilai tersembunyi dari total. Ini adalah default untuk Excel.
2 menyertakan nilai tersembunyi dalam total. Ini adalah nilai default pada server.

Alias untuk properti ini adalah VisualMode.

Kompatibilitas MDX

Tujuan dari properti ini adalah untuk memastikan serangkaian perilaku MDX yang konsisten untuk aplikasi yang mengeluarkan kueri MDX. Excel, yang menggunakan kueri MDX untuk mengisi dan menghitung PivotTable yang tersambung ke Analysis Services, mengatur properti ini ke 1, untuk memastikan bahwa anggota tempat penampung dalam hierarki yang tidak dibatasi terlihat dalam PivotTable. Nilai yang valid termasuk 0, 1, 2.

0 dan 1 mengekspos anggota tempat penampung; 2 tidak. Jika ini kosong, 0 diasumsikan.

Mode Anggota MDX Hilang

Menunjukkan apakah anggota yang hilang diabaikan dalam pernyataan MDX. Nilai yang valid adalah Default, Kesalahan, dan Abaikan. Default menggunakan nilai yang ditentukan server. Kesalahan menghasilkan kesalahan saat anggota tidak ada. Abaikan menentukan bahwa nilai yang hilang harus diabaikan.

Optimalkan Respons

Bitmask yang menunjukkan pengoptimalan respons kueri mana yang diaktifkan.

0x01 Gunakan NormalTupleSet (default).
0x02 Gunakan saat pemotong kosong.

Ukuran Paket

Hanya berlaku untuk koneksi TCP. Ukuran paket jaringan (dalam byte) antara 512 dan 32.767. Ukuran paket jaringan default adalah 4096.

Format Protokol

Mengatur format XML yang digunakan oleh protokol komunikasi XMLA. Nilai yang valid adalah Default, XML, atau Biner. Anda dapat menentukan XML yang dikirim dalam format biner atau sebagai XML teks. Format biner mengodekan elemen dan atribut XML, membuatnya lebih kecil. Selain itu, kompresi juga dapat diaktifkan untuk pesan untuk mengurangi ukuran permintaan dan respons menggunakan opsi Kompresi Transportasi. Permintaan dan respons dapat menggunakan format protokol yang berbeda tergantung pada apa yang didukung klien dan server. Misalnya, pustaka klien mungkin hanya mendukung biner untuk respons, tetapi tidak untuk permintaan, atau server mungkin telah menonaktifkan biner untuk permintaan masuk.

Penyedia OLE DB dapat memformat permintaan dan respons dalam format biner atau terkompresi. AMO dan ADOMD.NET memformat permintaan sebagai Teks, tetapi menerima respons dalam format biner atau terkompresi.

Properti string koneksi ini setara dengan pengaturan konfigurasi server EnableBinaryXML dan EnableCompression.

Real Time Olap

Atur properti ini untuk melewati penembolokan, menyebabkan semua kueri penyimpanan mengambil data dari sistem sumber. Secara default, properti ini tidak diatur.

Opsi Keamanan

Mengatur tingkat keamanan untuk fungsi dan tindakan yang ditentukan pengguna. Nilai yang valid adalah 0, 1, 2. Dalam koneksi Excel, properti ini adalah Opsi Keamanan=2. Detail tentang opsi ini dapat ditemukan di ConnectionString.

SQLQueryMode

Menentukan apakah kueri SQL menyertakan perhitungan. Nilai yang valid adalah Data, Calculated, IncludeEmpty. Data berarti bahwa tidak ada perhitungan yang diizinkan. Dihitung memungkinkan penghitungan. IncludeEmpty memungkinkan penghitungan dan baris kosong dikembalikan dalam hasil kueri.

Batas waktu

Menentukan berapa lama (dalam detik) pustaka klien menunggu perintah selesai sebelum menghasilkan kesalahan.

Kompresi Transportasi

Menentukan bagaimana komunikasi klien dan server dikompresi. Nilai yang valid adalah Default, Tidak Ada, Terkompresi. Tidak ada menunjukkan tidak ada pemadatan yang digunakan. Terkompresi menggunakan kompresi XPRESS.

UseExistingFile

Digunakan saat menyambungkan ke kubus lokal. Properti ini menentukan apakah kubus lokal ditimpa. Nilai yang valid adalah True atau False. Jika diatur ke True, file kubus harus ada. File yang ada akan menjadi target koneksi. Jika diatur ke False, file kubus akan ditimpa.

Lihat juga

Kelas Dasar AMO - Objek server
Kelas AdomdConnection - Properti