Kumaş Veri Ambarına bağlan

Applies to:✅ SQL analytics uç noktası ve Microsoft Fabric Deposu

Bu öğretici, araçlar ve uygulamaların SQL analiz uç noktanıza, ambarınıza veya bir ambarın anlık görüntüsüne nasıl bağlanacağını ele almaktadır.

Başlamak amacıyla, SQL Analiz Uç Noktası veya Ambar'a erişmeniz gerekir ve bunlar, Katkıda Bulunma veya daha yüksek izinlere sahip bir çalışma alanı içinde bulunmalıdır.

Depo bağlantı dizesini bulma

Ambar öğenizin sunucu adını bulmak için:

  1. Ambarınızın veya SQL analiz uç noktanızın Ayarlarını açın.

  2. Ayarlar penceresinde SQL uç noktası sayfasını seçin.

  3. SQL bağlantı dizesi kopyalayın ve Power BI masaüstü, uygulamalar veya istemci araçlarından öğeye dışarıdan bağlanmak için kullanın. Bu, ambarınızın sunucu adıdır.

  4. Bağlandığınızda ambar öğesi adını İlk Katalog veya Veritabanı adı olarak sağlamanız gerekir. InitialCatalog bağlantı dizesi özelliğini sağlamazsanız, başlangıçtaki bağlantı bağlamınız master veri ambarı olacaktır.

    Fabric portalındaki Ayarlar penceresinin SQL uç noktası sayfasının ekran görüntüsü.

SQL Server Management Studio (SSMS) kullanarak bağlanma

Aşağıdaki adımlar, Microsoft Fabric çalışma alanından başlamayı ve bir ambarı SQL Server Management Studio (SSMS)'a bağlamayı açıklar.

  1. SSMS'yi açtığınızda Sunucuya Bağlan penceresi görüntülenir. Zaten açıksa, Nesne Gezgini>Connect>Database Engine öğesini seçerek el ile bağlanabilirsiniz.

     Bağlan menüsünde Database Engine nerede seçileceği gösteren ekran görüntüsü.

  2. Sunucuya Bağlan penceresi açıldıktan sonra, bu makalenin önceki bölümünden kopyalanan bağlantı dizesini Sunucu adı kutusuna yapıştırın. Sunucu adınız <unique identifier>.datawarehouse.fabric.microsoft.com gibi görünür. Bağlan'ı seçin ve kimlik doğrulaması için uygun kimlik bilgileriyle devam edin.

    Sunucuya bağlan penceresini gösteren ekran görüntüsü.

  3. Bağlanmak istediğiniz ambar adını belirtin. Geçerli ambar adı, <unique identifier>.datawarehouse.fabric.microsoft.com için gerekli olan ögeleri içermez. Eğer ambarınızın adı NYC Taxi ise, İlk KataloğunuzNYC Taxi.

  4. Bağlantı kurulduktan sonra, Nesne Gezgini çalışma alanından bağlı ambarı ve tümü sorgulanmaya hazır olan ilgili tablo ve görünümlerini görüntüler.

    Ayarlı sunucu adının Nesne Gezgini bölmesinde nerede göründüğünü gösteren ekran görüntüsü.

SSMS veya Visual Studio Code üzerinden bağlandığınızda, hem SQL analiz uç noktasını hem de Ambar'ı ambar olarak listelenmiş olarak görürsünüz. Microsoft Fabric portalı deneyiminin dışındaki araçlarda çalışırken iki öğe türünü kolayca ayırt etmek için bir adlandırma kuralı benimseyin. Yalnızca SSMS 19 veya üzeri desteklenir.

Power BI kullanarak bağlanma

Warehouse veya Lakehouse SQL analiz uç noktası, Power BI içinde tam olarak desteklenen ve yerel bir veri kaynağıdır ve SQL Bağlantı dizesini kullanmaya gerek yoktur. Veri bölmesi, erişiminiz olan tüm ambarları doğrudan kullanıma sunar. Bu sayede ambarlarınızı çalışma alanına göre kolayca bulabilir ve:

  1. Depo'yu seçin.
  2. Varlıkları seçin.
  3. Veri Yükle - bir veri bağlantısı modu seçin: içeri aktarma veya DirectQuery.

Daha fazla bilgi için bkz. Microsoft Fabric'da veri ambarı hakkında raporlar oluşturma.

OLE DB kullanarak bağlanma

OLE DB kullanarak Ambar veya SQL analiz uç noktasına bağlantıyı destekliyoruz. En son Microsoft OLE DB Driver for SQL Server çalıştırdığınızdan emin olun.

ODBC kullanarak bağlanma

Microsoft Fabric ODBC kullanarak Ambar veya SQL analiz uç noktasına bağlantıyı destekler. SQL Server için en son ODBC Sürücüsünü çalıştırdığınızdan emin olun. Microsoft Entra ID kimlik doğrulamayı kullanın. Yalnızca ODBC 18 veya üzeri sürümler desteklenir.

Fabric Python Not Defteri'ni kullanarak bağlanma

Fabric Python Notebooks (önizleme), T-SQL sihirli komutunu kullanarak T-SQL kodunu çalıştırma imkanı sunar. Aşağıdaki adımlarda %%tsql sihirli komutunu kullanarak Fabric üzerindeki bir ambar öğesine bağlanın.

  1. Çalışma alanınızda dil Python olarak ayarlanmış bir not defteri oluşturun.

  2. Bir hücrede %%tsql sihirli komutunu kullanın. Hücre türü otomatik olarak T-SQL değişir.

    Aşağıdaki örnekte <warehouse> ile ambar öğenizin adını değiştirin. -type parametresi olmalıdırWarehouse.

    %%tsql -artifact <warehouse> -type Warehouse
    

    Ardından T-SQL komutunuzu ekleyin. Örneğin, adlı Contosobir ambardan sorgu çalıştırmak için:

    %%tsql -artifact Contoso -type Warehouse
    SELECT * FROM wh.DimDate;
    
  3. Sonuçları -bind bağımsız değişkeni ile bir veri çerçevesine de bağlayabilirsiniz.

    %%tsql -artifact Contoso -type Warehouse -bind df2
    

Python Not Defterleri'nin içinde T-SQL ile verilerinizi sorgulamak için bkz. Fabric Python not defterlerinde T-SQL kodunu çalıştırma. Söz diziminin tamamını görmek için komutunu kullanın %tsql? . Bu komut, kullanılabilir parametreler ve açıklamaları da dahil olmak üzere T-SQL sihirli komutunun yardım bilgilerini görüntüler.

JDBC kullanarak bağlanma

Microsoft Fabric ayrıca Java veritabanı bağlantısı (JDBC) sürücüsü kullanarak Ambar veya SQL analiz uç noktasına bağlantıyı da destekler.

JDBC aracılığıyla bağlantı kurarken aşağıdaki bağımlılıkları denetleyin:

  1. Öğeler ekleyin. Yapıt Ekle'yi seçin ve aşağıdaki dört bağımlılığı ekleyin, ardından tüm bağımlılıkları yüklemek için İndir/Güncelleştir'i seçin. Örneğin:

    İndir/Güncelleştir'in seçileceği yeri gösteren ekran görüntüsü.

  2. Bağlantıyı test et'i ve Son'u seçin.

    Bağımlılık Bildirimi sekmesinin ekran görüntüsü.

    <dependency>
       <groupId>com.microsoft.azure</groupId>
       <artifactId>msal4j</artifactId>
       <version>1.13.3</version>
    </dependency>
    
    <dependency>
       <groupId>com.microsoft.sqlserver</groupId>
       <artifactId>mssql-jdbc_auth</artifactId>
       <version>11.2.1.x86</version>
    </dependency>
    
     <dependency>
       <groupId>com.microsoft.sqlserver</groupId>
       <artifactId>mssql-jdbc</artifactId>
       <version>12.1.0.jre11-preview</version>
    </dependency>
    
     <dependency>
       <groupId>com.microsoft.aad</groupId>
       <artifactId>adal</artifactId>
       <version>4.2.2</version>
    </dependency>
    

dbt kullanarak bağlanma

Bağdaştırıcı dbt , sql ile kodu azaltmak, bağımlılık yönetimini otomatikleştirmek ve daha güvenilir veriler göndermek için test ve sürüm denetimi gibi yazılım mühendisliği en iyi yöntemlerini kullanan bir veri dönüştürme çerçevesidir.

Veri dbt platformuna özgü bağdaştırıcı eklentileri, kullanıcıların tercihleri olan veri deposuna bağlanmasına olanak sağlar. dbt adlı bir ambara bağlanmak için dbt-fabric bağdaştırıcısını kullanın. Benzer şekilde, Azure Synapse Analytics'e ait özel SQL havuzu veri kaynağının kendi bağdaştırıcısı dbt-synapse vardır.

Her iki bağdaştırıcı da Microsoft Entra ID kimlik doğrulamasını destekler ve geliştiricilerin az cli authentication kullanmasına olanak sağlar. Ancak, SQL kimlik doğrulaması için dbt-fabricdesteklenmez.

dbt Fabric DW Bağdaştırıcısı, Veri Ambarı ile bağlantı kurmak için pyodbc kitaplığını kullanır. pyodbc kitaplığı, Python Veritabanı API Belirtimi v2.0 kullanan Python dilde bir ODBC uygulamasıdır.  pyodbc kitaplığı, msodbc bağlantı yapısındaki SQLDriverConnect aracılığıyla bağlantı dizesini TDS (Tablolu Veri Akışı) proxy hizmetini kullanarak Microsoft Fabric'e ve veritabanı sürücüsüne doğrudan iletir.

Daha fazla bilgi için aşağıdaki kaynaklara bakın:

Diğer yollarla bağlantı

Microsoft olmayan herhangi bir araç, Microsoft Entra ID kimlik doğrulamasını kullanarak bir Microsoft Fabric Ambarı veya SQL analiz uç noktasına bağlanmak için ODBC veya OLE DB sürücüleri aracılığıyla SQL bağlantı dizesini de kullanabilir. Daha fazla bilgi ve örnek bağlantı dizeleri için bkz. SQL kimlik doğrulamasına alternatif olarak Microsoft Entra kimlik doğrulaması.

Özel uygulamalar

Microsoft Fabric'de bir ambar ve lakehouse SQL analiz uç noktası, SQL bağlantı dizesi sağlar. Verilere, Microsoft Entra ID kullanarak kimlik doğrulaması yapabilen sql araçlarının geniş bir ekosisteminden erişilebilir. Daha fazla bilgi için bkz. Microsoft SQL Veritabanı için bağlantı kitaplıkları. Daha fazla bilgi ve örnek bağlantı dizeleri için bkz. SQL kimlik doğrulamasına alternatif olarak Microsoft Entra kimlik doğrulaması.