Bağlantı dizesi özellikleri

Şunlar için geçerlidir: SQL Server Analysis Services Azure Analysis Services Fabric/Power BI Premium

Bu makalede, Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS) ve Power BI Premium anlam modellerine bağlanan ve bunları sorgulayan istemci uygulamaları tarafından kullanılan bağlantı dizesi özellikleri açıklanmaktadır. Bu özellikler Analysis Services için Analysis Services istemci kitaplıkları, ADOMD.NET, AMO ve OLE DB (MSOLAP) sağlayıcısı tarafından kullanılır. Bağlantı dizesi özelliklerinin çoğu üç istemci kitaplığıyla da kullanılabilir. Açıklama içinde özel durumlar çağrılır.

Yalnızca belirli bir platform veya sürüm için geçerli olan özellikleri görmek için soldaki içindekiler tablosunun üzerindeki Sürüm seçiciyi kullanın.

Bağlantı özellikleri

Veri Kaynağı

Sunucu örneğini belirtir. Bu özellik tüm bağlantılar için gereklidir.

SQL Server Analysis Services için geçerli değerler sunucunun ağ adını veya IP adresini, yerel bağlantılar için yerel veya localhost'ı, sunucu HTTP veya HTTPS erişimi için yapılandırılmışsa bir URL'yi veya yerel küp (.cub) dosyasının adını içerir.

Example	Description
Data source=AW-SRV01	SSAS varsayılan örneği ve bağlantı noktası (TCP 2383).
Data source=AW-SRV01\Finance	SSAS adlandırılmış örneği.
Data source=AW-SRV01:8081	SSAS varsayılan örneği, belirtilen bağlantı noktası.
Data source=AW-SRV01.corp.Adventure-Works.com	SSAS tam etki alanı adı, varsayılan örnek ve bağlantı noktası.
Data source=172.16.254.1	DNS sunucusu aramasını atlayarak sunucunun SSAS IP adresi. Bağlantı sorunlarını gidermek için kullanışlıdır.

Provider

Bu özellik, MSOLAP gibi bir OLE DB sağlayıcısı kullanılırken bağlantı dizesinde gereklidir. "Provider=MSOLAP" gibi sürümden bağımsız bir sağlayıcı (genellikle en son) kullanmanıza olanak tanır veya "Provider=MSOLAP.7" gibi sürüme bağımlı bir sağlayıcı da belirtebilirsiniz. Geçerli sürüm bağımlı değerleri MSOLAP desenini izler.<sürüm>, burada <sürüm> 7 veya 8'dir. Örneğin, SQL Server 2016'da yayımlanan MSOLAP.7. Sürüm ".8", en son sürümdür ve "evergreen" olarak kabul edilir. Geriye dönük uyumluluk korunarak güncelleştirmeye devam etmesi beklenir. Önceki sürüm numaraları da mümkündür, ancak MSOLAP'in bu sürümleri artık standart desteğin dışındadır.

Bu özellik ADOMD.NET ve AMO için isteğe bağlıdır. MSOLAP bağlantı dizesini ADOMD.NET ve AMO ile kullanmak üzere kopyalarken kolaylık sağlamasına izin verilir.

Example	Description
Provider=MSOLAP.7	Analysis Services için OLE DB sağlayıcısının SQL Server 2016 sürümünü gerektiren bağlantılar.

Küp

Küp adı veya perspektif adı. Bir veritabanı birden çok küp ve perspektif içerebilir. Birden çok hedef mümkün olduğunda, bağlantı dizesine küp veya perspektif adını ekleyin.

Example	Description
Cube=Sales	Satış adlı bir küp.
Cube=SalesPerspective	SalesPerspective adlı bir perspektif.

Kimlik doğrulaması ve güvenlik özellikleri

SQL Server Analysis Services yalnızca Windows kimlik doğrulaması kullanır. IIS 8.0 üzerinde Analysis Services'e HTTP Erişimini Yapılandırma makalesinde açıklandığı gibi, MSMDPUMP.dllaracılığıyla HTTP erişimi etkinleştirilirse temel kimlik doğrulaması ve anonim kimlik doğrulaması kullanılabilir. HTTP üzerinden Analysis Services için desteklenen kimlik doğrulama yöntemlerini yapılandırma hakkında ayrıntılı bilgi için 3. Adım: IIS kimlik doğrulamasını yapılandırma bölümüne bakın.

Özellikler alfabetik sırada listelenir.

EffectiveUserName

Sunucuda bir kullanıcı kimliğinin kimliğine bürünülmelidir. SSAS için etki alanı\kullanıcı biçiminde belirtin. Azure AS ve Power BI Premium için UPN biçiminde belirtin. Bu özelliği kullanmak için çağıranın Analysis Services'da yönetici izinlerine sahip olması gerekir. Power BI Premium'da, çağıranın anlam modelinin bulunduğu bir çalışma alanı yöneticisi olması gerekir.

CustomData

Bağlantı dizesindeki altyapıya geçirilecek ve ardından CustomData() MDX işlevi veya CUSTOMDATA() DAX işlevi kullanılarak alınacak dize değeri. En yaygın olarak bir userID veya kullanıcı adını değer olarak geçirmek ve ardından bu değeri bir güvenlik ifadesi tanımında belirtmek için kullanılır.

Parolayı Şifrele

Yerel küpleri şifrelemek için yerel parola kullanılıp kullanılmayacağını belirtir. Geçerli değerler True veya False'tur. Varsayılan değer False'tur.

Şifreleme Parolası

Şifrelenmiş yerel küplerin şifresini çözmek için kullanılan parola. Varsayılan değer boştur. Bu değer kullanıcı tarafından açıkça ayarlanmalıdır.

Kimliğe Bürünme Düzeyi

sunucunun istemcinin kimliğine bürünme sırasında kullanmasına izin verilen kimliğe bürünme düzeyini gösterir. Geçerli değerler şunlardır:

• Anonim. İstemci, sunucuya anonimdir. Sunucu işlemi istemci hakkında bilgi edinemez veya istemcinin kimliğine bürünülemez.
• Tanımla'ya bakın. Sunucu işlemi istemci kimliğini alabilir. Sunucu yetkilendirme amacıyla istemci kimliğinin kimliğine bürünebilir, ancak istemci olarak sistem nesnelerine erişemez.
• Kimliğine bürün. Bu varsayılan değerdir. İstemci kimliği, her çağrıda değil, yalnızca bağlantı kurulduğunda kimliğine bürünülebilir.
• Temsilci. Sunucu işlemi, istemci adına hareket ederken istemci güvenlik bağlamının kimliğine bürünebilir. Sunucu işlemi, istemci adına hareket ederken diğer sunuculara giden çağrılar da yapabilir.

Tümleşik Güvenlik

Çağıranın Windows kimliği Analysis Services'e bağlanmak için kullanılır. Geçerli değerler SSPI, blank, Basic ve ClaimsToken* değerleridir.

SSPI, NTLM, Kerberos veya Anonim kimlik doğrulamasına izin veren TCP bağlantıları için varsayılan değerdir. Azure AS ve Power BI Premium için SSPI , AD Çevirisi'ne işaret eder. SSPI kullanılırken ProtectionLevel özelliği Connect, Pkt Integrity veya Pkt Privacy olarak ayarlanmalıdır.

boş, HTTP bağlantıları için varsayılan değerdir.

*ClaimsToken, Azure AS ve Power BI Premium için desteklenir.

Güvenlik Bilgilerini Kalıcı Hale

Geçerli değerler True veya False'tur. True olarak ayarlandığında, daha önce bağlantı dizesinde belirtilen kullanıcı kimliği veya parola gibi güvenlik bilgileri, bağlantı kurulduktan sonra bağlantıdan alınabilir. Varsayılan değer False'tur.

Koruma Düzeyi

Bağlantıda kullanılan güvenlik düzeyini belirler. Desteklenen değerler, temel alınan aktarıma bağlıdır. Geçerli değerler şunlardır:

• Hiçbiri. Kimliği doğrulanmamış veya anonim bağlantılar. Sunucuya gönderilen verilerde kimlik doğrulaması gerçekleştirmez.
• Connect. Kimliği doğrulanmış bağlantılar. Yalnızca istemci bir sunucuyla ilişki kurduğunda kimlik doğrulaması yapar.
• Pkt Bütünlüğü. Şifrelenmiş bağlantılar. İstemciden tüm verilerin alındığını ve aktarım sırasında değiştirilmediğini doğrular.
• Pkt Gizlilik. İmzalı şifreleme, yalnızca TCP için desteklenir. İstemciden tüm verilerin alındığını, aktarım sırasında değiştirilmediğini doğrular ve verileri şifreleyerek gizliliği korur.

Daha fazla bilgi edinmek için bkz . ADOMD.NET'da Güvenli Bağlantılar Kurma

Görevler

Bu rol tarafından iletilen izinleri kullanarak bir sunucuya veya veritabanına bağlanmak için önceden tanımlanmış rollerin virgülle ayrılmış listesini belirtin. Bu özellik atlanırsa, tüm roller kullanılır ve etkili izinler tüm rollerin birleşimidir. Örneğin, özelliği boş bir değere ayarlamak, Roles=' ' istemci bağlantısının rol üyeliği olmadığı anlamına gelir.

Bu özelliği kullanan bir yönetici, rol tarafından iletilen izinleri kullanarak bağlanır. Rol yeterli izin sağlamazsa bazı komutlar başarısız olabilir.

Power BI Premium çalışma alanına bağlanırken rolleri belirtiyorsanız Power BI güvenlik modelindeki çalışma alanı rollerini kullanın.

SSPI

Tümleşik GüvenlikSSPI olarak ayarlandığında istemci kimlik doğrulaması için hangi güvenlik paketinin kullanılacağını açıkça belirtir. SSPI birden çok paketi destekler, ancak belirli bir paketi belirtmek için bu özelliği kullanabilirsiniz. Geçerli değerler şunlardır:

• Anlaşma
• Kerberos
• NTLM
• Anonim Kullanıcı

Bu özellik ayarlı değilse, tüm paketler bağlantı için kullanılabilir.

Veriler için Şifreleme kullanma

Veri iletimlerini şifreler. Geçerli değerler True veya False'tur.

Kullanıcı Kimliği=...; Parola=

kullanıcı kimliği ve parola özellikleri, istemci uygulamasındaki geçerli etkin kullanıcı sunucuya otomatik olarak yayılamıyorsa sunucuya uygun kimlik bilgilerini sağlar. Davranış, aktarım protokolüne ve bağlanılan sunucuya bağlıdır:

• TCP üzerinden SSAS'ye bağlanırken, istemci kitaplığı belirtilen kullanıcı adı ve parolayı kullanarak Windows kullanıcısının kimliğine bürünecek ve ardından her zamanki gibi sunucuya bağlanacaktır.

• HTTP(S) üzerinden SSAS'ye bağlanırken, kimlik bilgileri web sunucusunda yapılandırılan kimlik doğrulama moduna (örneğin Temel kimlik doğrulaması veya Windows kimlik doğrulaması) göre web sunucusuna sağlanır. Web sunucusu, SSAS sunucusuna bağlanmadan önce uygun Windows kimliğe bürünme işlemini gerçekleştirir ve bu nedenle sunucuya doğru kimlik bilgileri akışını sağlar.

• Azure AS veya Power BI Premium'a bağlanırken, kimlik doğrulaması sırasında hizmete sunulan bir Microsoft Entra belirtecini almak için Kullanıcı Kimliği ve Parola kullanılır. Microsoft Entra Id, belirtecin oluşturulabilmesi için ek kullanıcı etkileşimi gerektirebilen çok faktörlü kimlik doğrulaması (MFA) da gerektirebilir.

• Kendi uygulamanızdan zaten geçerli bir Microsoft Entra ID taşıyıcı erişim belirteci aldıysanız, bağlantıyı kurmadan önce AdomdConnection nesnesinin AccessToken özelliğini ayarlayabilirsiniz. İlgili bağlantı nesnesinin (AdomdConnection, Sunucu vb.) AccessToken özelliğinde, erişim belirtecini ayarladığınızdan ve süre sonunu belirttiğinizden emin olun. Kimlik doğrulaması, bir kullanıcı için etkileşimli olarak alınan taşıyıcı belirteçler için ve OAuth 2.0Behalf-Of akışı kullanılarak desteklenir (örneğin, kullanıcı adına Analysis Services'e bağlanan orta katman bir web uygulaması). AccessToken özelliğinde erişim belirtecini geçirirken belirteç türünü atlar. Analysis Services istemci kitaplıkları erişim belirtecine otomatik olarak "Taşıyıcı" kimlik doğrulama düzeni değerini ekler. Aşağıdakileri aklınızda bulundurun:

  • Microsoft Entra taşıyıcı erişim belirteçlerinin kullanım ömrü sınırlıdır. Varsayılan olarak, 60-90 dakika arasında. Uygulamanız erişim belirteci ömrünü aşan uzun süre çalışan işlemler gerçekleştiriyorsa, geçerli erişim belirtecinin süresi dolmak üzereyken erişim belirtecini yenilemek için AdomdConnection nesnesinin OnAccessTokenExpired özelliği aracılığıyla bir geri çağırma işlevi sağlayabilirsiniz. Alternatif olarak, AccessToken özelliğini geri çağırma işlevinin yardımı olmadan doğrudan güncelleştirebilirsiniz. Erişim belirtecinin geçerli erişim belirtecinin ömrü içinde yenilendiğinden emin olmak için geri çağırma işlevinin kullanılması önerilir.
  • Erişim belirteci geçirmek için Parola bağlantı dizesi özelliğinin kullanılması önerilmez. Yine de bağlantı dizesindeki Kullanıcı Kimliği özelliğini atlayabilir ve Password özelliğinde yalnızca erişim belirtecini belirtebilirsiniz, ancak bu durumlarda erişim belirteci yenilenemez. Gerektiğinde mevcut bir bağlantı için yeni bir erişim belirteci sağlayabilmeniz için bunun yerine AccessToken özelliğini kullanın. Password özelliğinin ve AccessToken özelliğinin ayarlanması desteklenmez.

Not: "Kullanıcı Kimliği" eklenmiş bir alana sahiptir. Kullanıcı Kimliği için alternatif bir diğer ad UID , Parola için alternatif diğer ad ise PWD'dir.

Özel amaçlı özellikler

Bu özellikler, bir uygulamanın gerektirdiği belirli bağlantı davranışlarını sağlamak için kullanılır. Özellikler alfabetik sırada listelenir.

Uygulama Adı

Bağlantıyla ilişkili uygulamanın adını ayarlar. Bu değer, özellikle aynı veritabanlarına erişen birkaç uygulamanız olduğunda izleme olaylarını izlerken yararlı olabilir. Örneğin, bir bağlantı dizesine Application Name='test' eklenmesi, 'test' öğesinin SQL Server Profil Oluşturucu izlemesinde görünmesine neden olur. Bu özelliğin diğer adları SspropInitAppName, AppName'tir. Daha fazla bilgi edinmek için bkz. SQL Server Bağlantıları için Uygulama Adı.

Otomatik Eşitleme Dönemi

İstemci ve sunucu önbelleği eşitleme sıklığını (milisaniye cinsinden) ayarlar. ADOMD.NET, en düşük bellek yüküne sahip sık kullanılan nesneler için istemci önbelleği sağlar. Bu, sunucuya gidiş dönüş sayısını azaltmaya yardımcı olur. Varsayılan değer 10.000 milisaniyedir (veya 10 saniyedir). Null veya 0 olarak ayarlandığında, otomatik eşitleme kapatılır.

Performans nedenleriyle, istemci kitaplıkları sunucudan bazı bilgileri (örneğin, belirli şema satır kümeleri) önbelleğe alır. Otomatik Eşitleme Dönemi, kullanıcının önbelleklerin boşaltılması gerekip gerekmediğini istemci kitaplığının sunucuyla denetlediği süreyi değiştirmesine olanak tanır. Genel olarak, değeri varsayılan değerden değiştirmeniz gerekmez.

Karakter Kodlama

karakterlerin istekte nasıl kodlanıldığını tanımlar. Geçerli değerler Varsayılan veya UTF-8 (eşdeğerdir) ve UTF-16'dır.

CommitTimeout

XMLA özelliği. Çalışmakta olan bir komutun işleme aşamasının ne kadar süreyle geri dönmeden önce bekleyeceğini milisaniye cinsinden belirler. 0'dan büyük olduğunda, sunucu yapılandırmasında karşılık gelen CommitTimeout özelliğinin değerini geçersiz kılar.

CompareCaseSensitiveStringFlags

Belirtilen yerel ayar için büyük/küçük harfe duyarlı dize karşılaştırmalarını ayarlar.

Sıkıştırma Düzeyi

TransportCompression sıkıştırılmışsa, ne kadar sıkıştırma kullanıldığını denetlemek için sıkıştırma düzeyini ayarlayabilirsiniz. Geçerli değerler 0 ile 9 arasındadır ve 0 en az sıkıştırmaya ve 9 en çok sıkıştırmaya sahip olur. Artan sıkıştırma performansı yavaşlatıyor. Varsayılan değer 0'dır.

Bağlanma Zaman Aşımı

İstemcinin zaman aşımına uğramadan önce bağlantı denemesi için gereken en uzun süreyi (saniye cinsinden) belirler. Bu süre içinde bir bağlantı başarılı olmazsa, istemci bağlanmaya çalışırken çıkar ve bir hata oluşturur.

DbpropMsmdRequestMemoryLimit

Bağlantı için Memory\QueryMemoryLimit sunucusu özellik değerini geçersiz kılar.

Kilobayt cinsinden belirtilen bu özellik sorgu sırasında kullanılan bellek miktarını QueryMemoryLimit içindeki izin verilen en yüksek bellekten (yüzde olarak belirtilir) azaltabilir . Kullanılan bellek miktarını QueryMemoryLimit içinde belirtilen izin verilen bellek üst sınırının ötesinde artıramaz.

Varsayılan MDX Görsel Modu

Boyut güvenliği uygulandığında üyelerin nasıl toplandığını denetlemek için bu özelliği ayarlayın.

Herkesin görmesine izin verilen küp verileri için, toplama katkıda bulunan tüm değerler görünür olduğundan üyelerin tümünün birleştirilmesi mantıklıdır. Ancak, kullanıcı kimliğine göre boyutları filtreler veya kısıtlarsanız, tüm üyeleri temel alan bir toplamın gösterilmesi (hem kısıtlanmış hem de izin verilen değerleri tek bir toplamda birleştirmek) kafa karıştırıcı olabilir veya ortaya çıkması gerekenden daha fazla bilgi gösterebilir.

Boyut güvenliği uygulandığında üyelerin nasıl toplandığını belirtmek için, bu özelliği yalnızca toplamada izin verilen değerleri kullanacak şekilde True veya kısıtlanmış değerleri toplamdan dışlamak için False olarak ayarlayabilirsiniz.

Bağlantı dizesinde ayarlandığında, bu değer küp veya perspektif düzeyine uygulanır. Bir modelde görsel toplamlarını daha ayrıntılı bir düzeyde denetleyebilirsiniz.

Geçerli değerler şunlardır:

• Varsayılan değer 0'dır . Şu anda varsayılan davranış 2'ye eşdeğerdir ve burada toplamalar kullanıcıdan gizlenen değerleri içerir.
• 1 , gizli değerleri toplamdan dışlar. Bu, Excel için varsayılan değerdir.
• 2 , toplama gizli değerleri içerir. Bu, sunucudaki varsayılan değerdir.

Bu özelliğin diğer adı VisualMode'dir.

MDX Uyumluluğu

Bu özelliğin amacı, MDX sorguları veren uygulamalar için tutarlı bir MDX davranışı kümesi sağlamaktır. Analysis Services'e bağlı bir PivotTable'ı doldurmak ve hesaplamak için MDX sorguları kullanan Excel, düzensiz hiyerarşilerdeki yer tutucu üyelerin PivotTable'da görünür olmasını sağlamak için bu özelliği 1 olarak ayarlar. Geçerli değerler 0, 1, 2'yi içerir.

0 ve 1 yer tutucu üyelerini kullanıma sunar; 2 yapmaz. Bu boşsa, 0 varsayılır.

MDX Eksik Üye Modu

Eksik üyelerin MDX deyimlerinde yoksayılıp yoksayılmadığını gösterir. Geçerli değerler Varsayılan, Hata ve Yoksay'dır. Varsayılan olarak sunucu tanımlı bir değer kullanılır. Hata, üye olmadığında bir hata oluşturur. Yoksay, eksik değerlerin yoksayılması gerektiğini belirtir.

Yanıtı en iyi duruma getirme

Aşağıdaki sorgu yanıtı iyileştirmelerinden hangisinin etkinleştirildiğini gösteren bit maskesi.

• 0x01 NormalTupleSet(varsayılan) kullanın.
• 0x02 Dilimleyiciler boş olduğunda kullanın.

Paket Boyutu

Yalnızca TCP bağlantıları için geçerlidir. 512 ile 32.767 arasında bir ağ paketi boyutu (bayt cinsinden). Varsayılan ağ paketi boyutu 4096'dır.

Protokol Biçimi

XMLA iletişim protokolü tarafından kullanılan XML biçimini ayarlar. Geçerli değerler Varsayılan, XML veya İkili'dir. XML'nin ikili biçimde veya metin XML'i olarak gönderilmesini belirtebilirsiniz. İkili biçim, XML öğelerini ve özniteliklerini kodlayarak daha küçük hale getirir. Ayrıca, aktarım sıkıştırma seçeneği kullanılarak isteklerin ve yanıtların boyutunu küçültmek için iletiler için sıkıştırma etkinleştirilebilir. İstekler ve yanıtlar, istemcinin ve sunucunun neyi desteklediğine bağlı olarak farklı protokol biçimleri kullanabilir. Örneğin, istemci kitaplığı yalnızca yanıtlar için ikiliyi desteklese de istekler için desteklemeyebilir veya bir sunucu gelen istekler için ikiliyi devre dışı bırakmış olabilir.

OLE DB sağlayıcısı istekleri ve yanıtları ikili veya sıkıştırılmış biçimde biçimlendirebilir. AMO ve ADOMD.NET istekleri Metin olarak biçimlendirin, ancak yanıtları ikili veya sıkıştırılmış biçimde kabul edin.

Bu bağlantı dizesi özelliği EnableBinaryXML ve EnableCompression sunucusu yapılandırma ayarlarına eşdeğerdir.

Gerçek Zamanlı Olap

Bu özelliği önbelleğe almayı atlayarak tüm depolama sorgularının kaynak sistemden veri getirmesine neden olacak şekilde ayarlayın. Varsayılan olarak, bu özellik ayarlanmadı.

Güvenlik Seçenekleri

Kullanıcı tanımlı işlevler ve eylemler için güvenlik düzeyini ayarlar. Geçerli değerler 0, 1, 2'dir. Excel bağlantısında bu özellik Güvenlik Seçenekleri=2'dir. Bu seçenekle ilgili ayrıntılar içinde ConnectionStringbulunabilir.

SQLQueryMode

SQL sorgularının hesaplamalar içerip içermediğini belirtir. Geçerli değerler Data, Calculated, IncludeEmpty değerleridir. Veriler, hesaplamalara izin verilmediğini gösterir. Hesaplanan, hesaplamalara izin verir. IncludeEmpty, sorgu sonucunda hesaplamaların ve boş satırların döndürülmesini sağlar.

Zaman Aşımı

İstemci kitaplığının hata oluşturmadan önce komutun tamamlanmasını ne kadar süreyle (saniye) bekleyeceğini belirtir.

Aktarım Sıkıştırması

İstemci ve sunucu iletişimlerinin nasıl sıkıştırıldıklarını tanımlar. Geçerli değerler Varsayılan, Yok, Sıkıştırılmış'tır. Hiçbiri sıkıştırmanın kullanılmadığını gösterir. Sıkıştırılmış, XPRESS sıkıştırma kullanır.

UseExistingFile

Yerel bir küpe bağlanırken kullanılır. Bu özellik, yerel küp üzerine yazıp yazılmayacağını belirtir. Geçerli değerler True veya False'tur. True olarak ayarlanırsa küp dosyasının mevcut olması gerekir. Mevcut dosya, bağlantının hedefi olacaktır. False olarak ayarlanırsa küp dosyasının üzerine yazılır.

Ayrıca bakınız

AMO Temel Sınıfları - Sunucu nesneleri
AdomdConnection Sınıfı - Özellikler