# Microsoft Fabric

Microsoft Fabric bir veri işlem hattında veya çoğaltma görevinde hedef veri platformu olarak kullanılabilir. Bir veri işlem hattında, verileri saklama, verileri dönüştürme, veri ambarları oluşturma ve veri kaydetme dahil olmak üzere hedef platformda çeşitli ELT işlemleri gerçekleştirilebilir. Diğer yandan çoğaltma görevi, temel dönüştürme yetenekleriyle ancak ELT işlemleri için destek olmadan, verilerin doğrudan bir kaynak sistemden bir hedef sisteme çoğaltılmasını içerir.

Bilgi notuData Movement gateway 2023.5.15 veya daha yeni bir sürümü gerektirir.

Hedef olarak Microsoft Fabric ayarlamak şunları içerir:

* [Ön koşulların yerine getirilmesi](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/fabric-target.htm#Prerequi2)
* Bir bulut hazırlama alanına (Azure Data Lake Storage) bağlantı yapılandırma. [Mevcut verileri kaydediyorsanız bu gerekli değildir](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm).
* Microsoft Fabric öğesine bağlantı yapılandırma

## Bulut hazırlama alanı kurma

Bilgi notu[Mevcut verileri kaydediyorsanız](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm) bir bulut hazırlama alanı kurmanıza gerek yoktur.

Ayrıca, uygulanıp depolanmadan önce verilerin ve değişikliklerin hazırlandığı bir Azure Data Lake Storage bulut hazırlama alanınız olması gerekir. Azure Data Lake Storage'a bağlantı kurma hakkında bilgi için bk. [Azure Data Lake Storage](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/adls-target.htm).

## Microsoft Fabric bağlantı özelliklerini ayarlama

Azure Data Lake Storage Hedef ayarlarını sağladıktan sonra aşağıdakileri yapın:

1. Bağlantılar'da Bağlantı oluştur'a tıklayın.

2. Microsoft Fabric hedef bağlayıcısını seçin ve ardından aşağıdaki ayarları sağlayın:

### Veri hedefi

#### Veri ağ geçidi

Bilgi notuData Movement gateway bu abonelik kademesiyle desteklenmediğinden bu alan, Qlik Talend Cloud Başlangıç Kılavuzu aboneliğiyle kullanılamaz.

Bir Data Movement gateway yalnızca hedef veritabanına Qlik Cloud öğesinden erişilemiyorsa ve yalnızca bir Özel Bağlantı kullanılarak erişilebiliyorsa gereklidir (örneğin, bir Sanal Özel Bulutta bulunuyorsa). Bu durumda, hedef veritabanına erişmek istediğiniz Data Movement gateway öğesini seçin.

Kullanım durumunuza bağlı olarak, bu ya veri kaynağından veri taşımak için dağıtılanData Movement gateway ile aynı ya da farklı bir veri kaynağı olacaktır.

Data Movement gateway kullanım durumları hakkında bilgi için bkz. [Ne zaman Data Movement gateway gereklidir?](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#top) ve [Yaygın kullanım durumları](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common).

Hedef veritabanına Qlik Cloud uygulamasından doğrudan erişilebiliyorsa Yok seçeneğini belirleyin.

Bilgi notuHedef veritabanına Data Movement gateway üzerinden erişirken, Data Movement gateway makinesine de uygun sürücüyü yüklemeniz gerekir. Ayrıntılar için aşağıdaki [Microsoft Fabric](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/fabric-target.htm#Driver) öğesine bakın.

### Bağlantı özellikleri

* Sunucu: Kullandığınız Microsoft Fabric Data Warehouse sunucusunun adı.

### Hesap özellikleri

Kimlik doğrulama yöntemi: Şunlardan birini seçin:

* Azure Active Directory Hizmet İlkesi

  Ardından belirtilen alanlara İstemci Kimliği ve İstemci Parolası bilgilerinizi girin.

* Azure Active Directory Kullanıcı İlkesi

  Ardından belirtilen alanlara Kullanıcı adı ve Parola girin.

### Veritabanı özellikleri

* Veritabanı adı: Bir veritabanını belirtmek için kullanabileceğiniz iki yöntem vardır:

  * Yöntem 1 - Listeden seçin: Veritabanlarını yükle'ye tıklayın ve ardından bir veritabanı seçin.
  * Yöntem 2 - Manuel olarak: Veritabanı adını manuel olarak girin seçeneğini belirleyin ve ardından veritabanı adını girin.

### Veri yükleme

* SAS belirteci: ADLS depolama hesabına erişmek için Microsoft Fabric tarafından kullanılacak SAS belirteci. [Mevcut verileri kaydediyorsanız bu gerekli değildir](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm).

### Ad

Bağlantı için görünen ad.

## Önkoşullar

### Veritabanı izinleri

Microsoft Fabric ayarlarının ODBC Erişimiconnector bölümünde Azure Active Directory Kullanıcısı/Hizmet İlkesi, Katkıda Bulunan rolünü almalıdır.

### Sürücü kurulumu

Bir sürücü yalnızca veritabanına Data Movement gateway üzerinden erişiyorsanız gereklidir. Böyle bir durumda, sürücüyü Data Movement gateway makinesine yüklemeniz gerekir.

driver öğesini, sürücü yükleme yardımcı programını kullanarak (önerilir) veya manuel olarak yükleyebilirsiniz. Manuel yükleme, nadir görülen şekilde sürücü yükleme yardımcı programında bir sorunla karşılaşmanız durumunda denenmelidir.

#### Sürücüyü yüklemek için sürücü yükleme yardımcı programı kullanma

Bu bölümde, gerekli driver öğesinin nasıl yükleneceği açıklanmıştır. Sürece, gerekli driver öğesini otomatik olarak indirecek, yükleyecek ve yapılandıracak bir komut dosyası çalıştırma işlemi dahildir. Gerektiğinde driver öğesini güncellemek ve kaldırmak için de komut dosyaları çalıştırabilirsiniz.

Yüklemeyi hazırlama

* Python 3.6 veya daha yeni bir sürümünün Data Movement ağ geçidi sunucusunda yüklü olduğundan emin olun.

  Python, çoğu Linux dağıtımında önceden yüklenmiş şekilde sunulur. Aşağıdaki komutu çalıştırarak sisteminizde yüklü olan Python sürümünü öğrenebilirsiniz:

  python3 --version

driver uygulamasını yükleme

driver öğesini indirip yüklemek için:

1. Veri Hareketi ağ geçidi hizmetini durdurun:

   sudo systemctl stop repagent

2. İsteğe bağlı olarak hizmetin durduğunu doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Data Movement ağ geçidi makinesinde, çalışan dizini şu şekilde değiştirin:

   opt/qlik/gateway/movement/drivers/bin

4. Şu komutu çalıştırın:

   Söz Dizimi:

   ./install fabric

   driver yüklenemiyorsa (erişim kısıtlamaları veya teknik sorunlar nedeniyle) driver öğesini nereden indireceğiniz ve Data Movement ağ geçidi makinesinde nereye kopyalayacağınız konusunda size talimat veren bir mesaj görünür. Bu işlemi yaptıktan sonra install fabric komutunu tekrar çalıştırın.

   Aksi durumda, driver öğesinin EULA'sı görünür.

5. Şunlardan birini yapın:

   * EULA'da yavaşça gezinmek için [Enter] tuşuna tekrar tekrar basın.
   * EULA'da hızlı bir şekilde gezinmek için Boşluk tuşuna tekrar tekrar basın.
   * Lisans metninden çıkmak ve EULA kabul seçeneklerine ulaşmak için q tuşuna basın.

6. Şunlardan birini yapın:

   * EULA'yı kabul etmek ve yükleme işlemini başlatmak için "y" yazıp [Enter] tuşuna basın.

   * EULA'yı reddetmek ve yükleme işleminden çıkmak için "n" yazıp [Enter] tuşuna basın.

   * EULA'yı tekrar görüntülemek için "v" yazıp [Enter] tuşuna basın.

   driver yüklenir.

7. Yüklemenin tamamlanmasını ("Tamamlandı!" ifadesiyle belirtilir) bekleyin ve ardından Veri Hareketi ağ geçidi hizmetini başlatın:

   sudo systemctl start repagent

8. İsteğe bağlı olarak hizmetin başlatıldığını doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: active (running) since &lt;timestamp&gt; ago

driver öğesini güncelleme

Sağlanan driver öğesini yüklemeden önce driver öğesinin eski sürümlerini kaldırmak istiyorsanız güncelleme komutunu çalıştırın.

driver öğesini indirip güncellemek için:

1. Veri Hareketi ağ geçidi hizmetini durdurun:

   sudo systemctl stop repagent

2. İsteğe bağlı olarak hizmetin durduğunu doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Data Movement ağ geçidi makinesinde, çalışan dizini şu şekilde değiştirin:

   opt/qlik/gateway/movement/drivers/bin

4. Şu komutu çalıştırın:

   Söz Dizimi:

   ./update fabric

   driver yüklenemiyorsa (erişim kısıtlamaları veya teknik sorunlar nedeniyle) driver öğesini nereden indireceğiniz ve Data Movement ağ geçidi makinesinde nereye kopyalayacağınız konusunda size talimat veren bir mesaj görünür. Bu işlemi yaptıktan sonra update fabric komutunu tekrar çalıştırın.

   Aksi durumda, driver öğesinin EULA'sı görünür.

5. Şunlardan birini yapın:

   * EULA'da yavaşça gezinmek için [Enter] tuşuna tekrar tekrar basın.
   * EULA'da hızlı bir şekilde gezinmek için Boşluk tuşuna tekrar tekrar basın.
   * Lisans metninden çıkmak ve EULA kabul seçeneklerine ulaşmak için q tuşuna basın.

6. Şunlardan birini yapın:

   * EULA'yı kabul etmek ve yükleme işlemini başlatmak için "y" yazıp [Enter] tuşuna basın.
   * EULA'yı reddetmek ve yükleme işleminden çıkmak için "n" yazıp [Enter] tuşuna basın.
   * EULA'yı baştan incelemek için "v" yazıp [Enter] tuşuna basın.

   Eski driver kaldırılacak ve yeni driver yüklenecektir.

7. Yüklemenin tamamlanmasını ("Tamamlandı!" ifadesiyle belirtilir) bekleyin ve ardından Veri Hareketi ağ geçidi hizmetini başlatın:

   sudo systemctl start repagent

8. İsteğe bağlı olarak hizmetin başlatıldığını doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: active (running) since &lt;timestamp&gt; ago

driver öğesini kaldırma

driver öğesini kaldırmak istiyorsanız kaldırma komutunu çalıştırın.

driver öğesini kaldırmak için:

1. Bu bağlayıcıyı kullanmak için yapılandırılan tüm görevleri durdurun.

2. Data Movement ağ geçidi makinesinde, çalışan dizini şu şekilde değiştirin:

   opt/qlik/gateway/movement/drivers/bin

3. Şu komutu çalıştırın:

   Söz Dizimi:

   ./uninstall fabric

   driver kaldırılacaktır.

#### Sürücüyü manuel olarak yükleme

driver öğesini manuel olarak yüklemeyi yalnızca otomatik sürücü yükleme başarıyla tamamlanmadığında denemelisiniz.

Hem bir ODBC sürücüsü hem de bir JDBC sürücüsü yüklemeniz gerekir.

ODBC sürücüsünün yüklenmesi

Data Movement gateway yüklendikten sonra msodbcsql&lt;version&gt;.x86\_64.rpm sürücüsünü indirin. Desteklenen sürüme ait doğrudan bir indirme bağlantısını /opt/qlik/gateway/movement/drivers/manifests/fabric.yaml. içindeki binary-artifacts altında bulabilirsiniz. İndirme tamamlandığında RPM'yi Data Movement gateway makinesine kopyalayın.

1. Veri Hareketi ağ geçidi hizmetini durdurun:

   sudo systemctl stop repagent

2. İsteğe bağlı olarak hizmetin durduğunu doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: inactive (dead) since &lt;timestamp&gt; ago

3. Sürücüyü Veri Hareketi ağ geçidi makinesine yükleyin.

4. Sürücü konumunu `site_arep_login.sh` dosyasına aşağıdaki gibi kopyalayın:

   ```
   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/lib64/" >> site_arep_login.sh
                           
   ```

   Örnek:

   ```
   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql17/lib64/" >> site_arep_login.sh
                           
   ```

   Bu, sürücüyü "LD\_LIBRARY\_PATH" değişkenine ekler ve **site\_arep\_login.sh** dosyasında sürücü konumunu günceller.

5. İsteğe bağlı olarak sürücü konumunun kopyalandığını doğrulayın:

   ```
   cat site_arep_login.sh
                           
   ```

6. Veri Hareketi ağ geçidi hizmetini başlatın.

   sudo systemctl start repagent

7. İsteğe bağlı olarak hizmetin başlatıldığını doğrulayın:

   sudo systemctl status repagent

   Durum aşağıdaki gibi olmalıdır:

   Active: active (running) since &lt;timestamp&gt; ago

JDBC sürücüsünün yüklenmesi

1. /opt/qlik/gateway/movement/drivers/manifests/fabric.yaml dizinindeki binary-artifacts altında listelenen JAR dosyalarını indirin. Ardından dosyaları Data Movement gateway makinesinde aşağıdaki klasöre kopyalayın:

   /opt/qlik/gateway/movement/qcs\_agents/qdi-db-commands/lib

2. Data Movement gateway bölümünde açıklanan komutu çalıştırarak [Hizmeti yeniden başlatma](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm#Restarti2) hizmetini yeniden başlatın

Uyarı notuMicrosoft SQL Server veri kaynağı (CDC tabanlı veya günlük tabanlı) kullanıyorsanız Fabric sürücüsünün yüklemesi kaldırıldırıldığında, ikisi aynı sürücüyü paylaştığından SQL Server bağlantısı da kesilecektir.

### Bağlantı Noktaları

Giden iletişim için bağlantı noktası 1433'ü açın.

## Sınırlamalar ve dikkate alınacak noktalar

* Aşağıdaki işlemler desteklenmez ve hedefe uygulanmaz:

  * RENAME sütunu
  * DROP/ALTER sütunu

* Yeni eklenen sütunlar (ADD COLUMN) null değer alabilmelidir.

Bilgi notu

Data Movement gatewayy 2026.5.1 sürümünden itibaren, hedef veri türleri `8000` yerine `MAX` uzunluğuna eşlenir. Eşlemeyi kayıtlı veri, depolama, dönüştürme, data mart ve knowledge mart görevlerindeki mevcut sütunlara uygulamak için sütun veri türünü değiştirmek veya tabloları yeniden oluşturmak üzere `ALTER TABLE` çalıştırın. Diğer görev türleri için tabloları yeniden oluşturun.

## Veri türleri

Aşağıdaki tabloda Microsoft Fabric kullanırken desteklenen Qlik Cloud veri türleri ve Qlik Cloud veri türlerine ait varsayılan eşleme gösteriliyor.

Yerel veri türü bilgileri korunur ve veri kümesi görünümlerinde Yerel veri türü sütununda görüntülenir. Sütun görünür değilse veri kümesi görünümünün sütun seçicisini açmanız ve Yerel veri türü sütununu seçmeniz gerekir.

Desteklenen veri türleri

| Qlik Talend Data Integration veri türü | Microsoft Fabric veri türleri |
| --- | --- |
| BOOL | BIT |
| BYTES | Uzunluk 1-8000 ise:<br><br>VARBINARY (Bayt Olarak Uzunluk)<br><br>Uzunluk 8000 baytı aşarsa BYTES, VARBINARY (MAX) ile eşlenir. |
| DATE | DATE |
| TIME | Ölçek 0-6 ise:<br><br>TIME (Ölçek)<br><br>Ölçek 6'yı aşıyorsa:<br><br>TIME (6) |
| TIMESTAMP | Ölçek 0-6 ise:<br><br>DATETIME2 (Ölçek)<br><br>Ölçek 6'yı aşıyorsa:<br><br>DATETIME2 (6) |
| INT1 | SMALLINT |
| INT2 | SMALLINT |
| INT4 | INT |
| INT8 | BIGINT |
| NUMERIC | DECIMAL (p,s) |
| REAL4 | FLOAT(24) |
| REAL8 | FLOAT(53) |
| STRING | Uzunluk 1-8000 ise:<br><br>VARCHAR (Bayt Olarak Uzunluk)<br><br>Bayt cinsinden uzunluk 8000'i aşarsa STRING, VARCHAR (MAX) olarak eşleştirilir. |
| UINT1 | SMALLINT |
| UINT2 | INT |
| UINT4 | BIGINT |
| UINT8 | DECIMAL (20,0) |
| WSTRING | Uzunluk 1-8000 ise:<br><br>VARCHAR (Bayt Olarak Uzunluk)<br><br>Bayt cinsinden uzunluk 8000'i aşarsa WSTRING, VARCHAR (MAX) ile eşleştirilir. |
| BLOB | VARBINARY (maks.) |
| NCLOB | VARCHAR (maks.) |
| CLOB | VARCHAR (maks.) |
| JSON | VARCHAR (maks.) |

Bilgi notuTam LOB veri türleri desteklenmez. Sınırlı boyutlu LOB veri türlerini moving içine dahil etme hakkında bilgi için bkz. [Veri kaynaklarından veri yerleştirme](https://help.qlik.com/tr-TR/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Landing-data-data-sources.htm#Runtime).