Fivetran から Microsoft Fabric にデータを同期する手順


## 概要

Fivetran から Microsoft Fabric にデータを同期する手順を紹介します。

- [Fivetran for OneLake | Destination Setup Guide](https://fivetran.com/docs/destinations/onelake/setup-guide)

本記事は下記記事の一部です。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/d5372a04-4384-4eb1-8120-075f8cbbb7e6.png)

出所：[フルマネージドなデータ連携：データ統合の自動化を実現する Fivetran の全貌 #fivetran - Qiita](https://qiita.com/manabian/items/2a760238d3fc1021aae7)


:::note warn

アンダースコアに関する制限がある旨の記述があるため、下記の条件に該当するスキーマ、あるいは、テーブルを同期する際には注意してください。

> - The table and schema names must not start or end with an underscore, and must not contain multiple consecutive underscores ( __ ).

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/0466ea66-b781-4d5d-ae4e-cee737bdb5e7.png)

出所：[Fivetran for OneLake Implementation | Configuration and documentation](https://fivetran.com/docs/destinations/onelake#limitations)

ただし、2025年4月22日日時点では想定通りに同期されました。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/0ade5945-cdf9-45a8-8d84-739e9b5db2fb.png)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/4d2be162-b2f8-40e1-9583-2878a7a8e4ab.png)

:::


## 手順

### Register application and add service principal 

Azure Portal にて`Microsoft Entra ID` -> `アプリの登録` -> `+ 新規登録`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/4ca2bbdf-8e86-45aa-9b71-8f02ff734d39.png)

任意の名前（例：`fivetran-service-principal`）を入力し、`登録`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/231cbcca-7b57-4243-94cc-585c30e6a79a.png)

`アプリケーション (クライアント) ID`の値と`ディレクトリ (テナント) ID
`の値をひかえます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/08d881a4-3143-4ac8-9825-693ae7be713d.png)

### Create client secret 

作成したアプリの画面にて、`証明書とシークレット` -> `クライアントシークレット` -> `+ 新しいクライアントシークレット`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/e63c352e-7be8-4347-b3bb-8f5d400f4d9c.png)

説明に任意の値を入力し、`追加`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/432877c3-718b-49dd-a3ab-2458f66ddfe4.png)

`値`に表示されている値を控えます。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/8795cb0b-b107-47e5-84a8-f2f93d18e34d.png)

### Create workspace 

Microsoft Fabric にログインし、右上の歯車ボタン -> `管理ポータル`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/3661d65c-4c19-4697-a4d1-c753db7de2ee.png)

`サービス プリンシパルは Fabric API を使用できます`の設定を有効化します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/c7b96b44-d7cc-43a1-bd9c-ec6ae66f4a5f.png)

`ユーザーは、Fabric 外部のアプリを使用して OneLake の格納データにアクセスできます`の設定を有効化します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/73cc91f3-0222-4919-b857-1285da71c411.png)

左側の`ワークスペース` -> `+ 新しいワークスペース`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/7b67188f-ca6a-4ba5-b549-67a8f1690b35.png)

任意の名前（例:`Onlake_Fivetran`）を入力し、`適用`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/75c051cc-2788-4a0d-94ac-75b081ddc609.png)

### Add service principal to workspace

作成したワークスペースの画面にて、右上にある`アクセスの管理`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/fa24286c-21b3-49c4-80a2-f5e471697588.png)

`+ ユーザーまたはグループの追加`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/d3a86b1a-df4d-4def-b85d-4f16ecdfcc57.png)

作成したサービスプリンシパルを追加し、`共同作成者`に変更した上で`追加`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/9310e461-4b18-4469-829a-2523b507d6da.png)


### Create lakehouse 

作成したワークスペースにて、`+ 新しい項目`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/ad742eb4-0ecc-4a6f-9c36-59ac41a36c9b.png)

`レイクタウン`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/45c9ef41-48f4-4f22-a9af-7451374607cb.png)

任意の名前（例：`Lakehouse_Fivetran`）を入力し、`作成`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/ff6c6503-2246-4e2a-a975-6d30f1bd5c7c.png)

ワークスペースの URL から Workspace GUID と Lakehouse GUID を控えます。URL の groups の後の値が Workspace GUID であり、lakehouses の後の値が Lakehouse GUID です。

> https://app.fabric.microsoft.com/groups/1af269c2-0b2c-4b7b-88c6-8256ab75a1c0/lakehouses/a95436f3-f124-4758-bad9-1219a9618f0d?experience=fabric-developer

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/e990c4d8-e7b2-4490-9526-4ba9d3eb45c3.png)

### Complete Fivetran configuration 

Fivetran にて`Destinations` -> `Add Destination`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/f13fe824-cf2a-47c6-8eae-52ea1dd297aa.png)

`OneLake`の`Select`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/037b353c-55f3-416c-9c85-706f752f8332.png)

任意の名前（例：`onelake_01`）を入力し、`Add`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/f36e85cb-8017-469e-9859-3705ec2a17f1.png)

Destination のセットアップ画面が表示されることを確認します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/0da7e378-4d69-4097-8b6a-546417cd9b19.png)

 Workspace GUID と Lakehouse GUID を入力します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/b976e148-5cc5-47c2-b1b9-f96f89db6686.png)

サービスプリンシパルに関する情報を入力します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/0fa5df86-26a5-4fe5-aef2-b3a1cf21fa2b.png)

`Save & Test`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/da69e70c-9ca4-41dc-a8d1-4f99c5286c6d.png)

### Setup test

検証が正常終了することを確認します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/68f20798-9c7a-4654-bf19-b72966875a73.png)


## データの同期

### Fivetran にてデータ同期の実施

`Connection` -> 作成した Destinon が利用されているコネクションを選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/d0e36db3-831f-4ee5-8ff8-613b2bd00c90.png)

`Start Initial Sync`を選択します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/1c79b2d9-5adf-448e-b159-58b45b3ca326.png)

同期が完了することを確認します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/2c892629-5de9-4298-82ce-172e03808d41.png)

### Microsoft Fabric にてデータを確認

データが同期されていることを確認します。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/24031/a655b1b1-2360-493e-a82f-bde1f45f5c80.png)