Kılavuz: Fabric Veri Ambarı için dbt ayarlama

Şunlar için geçerlidir:✅ Warehouse in Microsoft Fabric

Bu öğretici, dbt'yi kurma ve ilk projenizi Fabric Warehouse'a dağıtma sürecinde size adım adım rehberlik eder.

Introduction

dbt (Veri Derleme Aracı) açık kaynak çerçevesi, veri dönüştürme ve analiz mühendisliğini basitleştirir. Analiz katmanındaki SQL tabanlı dönüşümlere odaklanarak SQL'i kod olarak ele alır. dbt sürüm denetimini, modülerleştirmeyi, testi ve belgeleri destekler.

Microsoft Fabric için dbt bağdaştırıcısı, daha sonra bir Fabric Veri Ambarı'na dağıtılabilecek dbt projeleri oluşturmak için kullanılabilir.

Örneğin, yalnızca bağdaştırıcıyı değiştirerek dbt projesinin hedef platformunu da değiştirebilirsiniz; Azure Synapse ayrılmış SQL havuzu için oluşturulmuş bir proje birkaç saniye içinde Doku Veri Ambarı'na yükseltilebilir.

Microsoft Fabric için dbt bağdaştırıcısının önkoşulları

dbt önkoşullarını yüklemek ve ayarlamak için bu listeyi izleyin:

Python sürüm 3.7 (veya üzeri).
SQL Server için Microsoft ODBC Sürücüsü.
dbt-fabric bağdaştırıcısının en son sürümünü kullanarak edinin.
```
pip install dbt-fabric
```
Note

pip install dbt-fabric şunu pip install dbt-synapse olarak değiştirerek ve aşağıdaki yönergeleri kullanarak Synapse ayrılmış SQL havuzu için dbt bağdaştırıcısını yükleyebilirsiniz.
komutunu kullanarak pip list dbt-fabric ve bağımlılıklarının yüklendiğinden emin olun:
```
pip list
```
Paketlerin ve geçerli sürümlerin uzun bir listesi bu komuttan döndürülmelidir.
Henüz yoksa bir Ambar oluşturun. Bu alıştırma için deneme kapasitesini kullanabilirsiniz: Microsoft Fabric ücretsiz deneme sürümüne kaydolun, bir çalışma alanı oluşturun ve ardından bir ambar oluşturun.

dbt-fabric bağdaştırıcısını kullanmaya başlama

Bu öğreticide Visual Studio Code kullanılır, ancak tercih ettiğiniz aracı kullanabilirsiniz.

jaffle_shop demo dbt projesini makinenize kopyalayın.
- Visual Studio Code'un yerleşik kaynak denetimiyle depoyu kopyalayabilirsiniz.
- Örneğin, komutunu kullanabilirsiniz git clone :
```
git clone https://github.com/dbt-labs/jaffle-shop-classic.git
```
jaffle_shop Visual Studio Code'da proje klasörünü açın.
Zaten bir Ambar oluşturduysanız, kaydolmayı atlayabilirsiniz.
Bir profiles.yml dosyası oluşturun. aşağıdaki yapılandırmayı öğesine profiles.ymlekleyin. Bu dosya, dbt-fabric bağdaştırıcısını kullanarak Microsoft Fabric'teki ambarınıza bağlantıyı yapılandırıyor.
```
config:
  partial_parse: true
jaffle_shop:
  target: fabric-dev
  outputs:    
    fabric-dev:
      authentication: CLI
      database: <put the database name here>
      driver: ODBC Driver 18 for SQL Server
      host: <enter your SQL analytics endpoint here>
      schema: dbo
      threads: 4
      type: fabric
```
Note

type öğesini fabric olarak synapse olarak değiştirerek, isterseniz veritabanı bağdaştırıcısını Azure Synapse Analytics'e dönüştürebilirsiniz. Veritabanı bağdaştırıcısı değiştirilerek mevcut dbt projelerinin veri platformları güncelleştirilebilir. Daha fazla bilgi için desteklenen veri platformlarının dbt listesine bakın.
Visual Studio Code terminalinde Azure'da kimliğinizi doğrulayın.
- Azure CLI kimlik doğrulaması kullanıyorsanız Visual Studio Code terminalinde komutunu çalıştırın az login .
- Microsoft Fabric'teki Hizmet Sorumlusu veya diğer Microsoft Entra Kimliği (eski adıyla Azure Active Directory) kimlik doğrulaması için dbt (Veri Derleme Aracı) kurulumu ve dbt Kaynak Yapılandırmaları'na bakın. Daha fazla bilgi için bkz . Microsoft Fabric'te SQL kimlik doğrulamasına alternatif olarak Microsoft Entra kimlik doğrulaması.
Artık bağlantıyı test etmeye hazırsınız. Ambarınıza bağlantıyı test etmek için Visual Studio Code terminalinde komutunu çalıştırın dbt debug .
```
dbt debug
```
Tüm denetimlerden geçildi, yani dbt projesinden jaffle_shop dbt-fabric bağdaştırıcısını kullanarak ambarınıza bağlanabilirsiniz.
Şimdi bağdaştırıcının çalışıp çalışmadığını test etme zamanı geldi. İlk olarak ambara örnek veri eklemek için komutunu çalıştırın dbt seed .
demo dbt projesinde tanımlanan modelleri çalıştırmak için komutunu çalıştırın dbt run .
```
dbt run
```
Bazı testlerde verileri doğrulamak için komutunu çalıştırın dbt test .
```
dbt test
```

Şimdi Fabric Data Warehouse'a bir dbt projesi dağıttınız.

Farklı ambarlar arasında hareket etme

Dbt projesini farklı ambarlar arasında taşımak kolaydır. Desteklenen herhangi bir ambardaki dbt projesi bu üç adımlı işlemle hızla geçirilebilir:

Yeni bağdaştırıcıyı yükleyin. Daha fazla bilgi ve tam yükleme yönergeleri için bkz. dbt bağdaştırıcıları.
type dosyasındaki profiles.yml özelliğini güncelleştirin.
Projeyi oluşturun.

"Fabric Data Factory'de dbt"

Popüler bir iş akışı yönetim sistemi olan Apache Airflow ile tümleştirildiğinde dbt, veri dönüşümlerini düzenlemeye yönelik güçlü bir araç haline gelir. Airflow'un zamanlama ve görev yönetimi özellikleri, veri ekiplerinin dbt çalıştırmalarını otomatikleştirmesine olanak tanır. Düzenli veri güncelleştirmeleri sağlar ve analiz ve raporlama için tutarlı bir yüksek kaliteli veri akışı sağlar. Airflow'un iş akışı yönetimiyle dbt'nin dönüşüm uzmanlığını kullanan bu birleşik yaklaşım verimli ve sağlam işlem hatları sunar ve sonuç olarak daha hızlı ve daha içgörülü veri odaklı kararlar alınmasına yol açar.

Apache Airflow , karmaşık veri iş akışlarını program aracılığıyla oluşturmak, zamanlamak ve izlemek için kullanılan açık kaynak bir platformdur. İşlem hatlarını temsil etmek için yönlendirilmiş döngüsel grafiklere (DAG) birleştirilebilen işleçler olarak adlandırılan bir görev kümesi tanımlamanızı sağlar.

Dbt'yi ambarınızla kullanıma hazır hale getirmek için bkz. Microsoft Fabric'te Data Factory ile dbt kullanarak verileri dönüştürme.

Dikkate Alınacaklar

dbt-fabric bağdaştırıcısı kullanılırken dikkate alınması gereken önemli şeyler:

Microsoft Fabric veri ambarı ile ilgili geçerli sınırlamaları gözden geçirin.
Fabric, kullanıcı ilkeleri, kullanıcı kimlikleri ve hizmet ilkeleri için Microsoft Entra ID (eski adıyla Azure Active Directory) kimlik doğrulamasını destekler. Ambar üzerinde etkileşimli olarak çalışmak için önerilen kimlik doğrulama modu CLI'dir (komut satırı arabirimleri) ve otomasyon için hizmet sorumlularını kullanır.
Doku Veri Ambarı'nda desteklenmeyen T-SQL (Transact-SQL) komutlarını gözden geçirin.
Bazı T-SQL komutları, Create Table as Select (CTAS), DROP, ve CREATE gibi komutlar kullanılarak dbt-fabric bağdaştırıcısı tarafından desteklenir, örneğin ALTER TABLE ADD/ALTER/DROP COLUMN, MERGE, TRUNCATE, sp_rename.
Desteklenen ve desteklenmeyen veri türleri hakkında bilgi edinmek için Desteklenmeyen veri türlerini gözden geçirin.
GitHub'da dbt-fabric bağdaştırıcısında sorunları kaydetmek için Sorunlar · microsoft/dbt-fabric · GitHub adresini ziyaret edebilirsiniz.

Sonraki adım

Microsoft Fabric'te Data Factory ile dbt kullanarak verileri dönüştürme

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2025-09-26