# Microsoft Fabric Microsoft Fabric は、データ パイプラインまたはレプリケーション タスクのターゲット データ プラットフォームとして使用できます。データ パイプラインでは、データの保存、データの変換、データ マートの作成、データの登録など、さまざまな ELT 操作をターゲット プラットフォーム上で実行できます。一方、レプリケーション タスクでは、基本的な変換機能を備え、ソース システムからターゲット システムへ直接データをレプリケートしますが、ELT 操作はサポートしません。 情報メモData Movement gateway 2023.5.15 以降が必要です。 Microsoft Fabric をターゲットとして設定するには、次が必要です。 * [前提条件を満たす](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/fabric-target.htm#Prerequi2) * クラウド ステージング エリア (Azure Data Lake Storage) への接続を構成する。これは、[既存のデータを登録する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm)場合は必要ありません。 * Microsoft Fabric への接続を構成する ## クラウド ステージング エリアの設定 情報メモ[既存のデータを登録する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm)場合は、クラウド ステージング エリアを設定する必要はありません。 また、データと変更が適用および保存される前にステージングされる Azure Data Lake Storage クラウド ステージング エリアも必要です。Azure Data Lake Storage への接続の設定については、「[Azure Data Lake Storage](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/adls-target.htm)」を参照してください。 ## Microsoft Fabric 接続プロパティの設定 Azure Data Lake Storage ターゲット設定を指定したら、次の操作を行います。 1. [接続] で、[接続を作成] をクリックします。 2. Microsoft Fabric ターゲット コネクタを選択し、次の設定を行います。 ### データ ターゲット #### データ ゲートウェイ 情報メモこのサブスクリプション ティアでは Data Movement gateway がサポートされていないため、Qlik Talend Cloud スターター サブスクリプションではこの項目を使用できません。 Data Movement gateway は、ターゲット データベースが Qlik Cloud からアクセスできない場合にのみ必要で、プライベート リンクを使用してのみアクセスできます ( Virtual Private Cloud にある場合など) 。該当する場合には、ターゲット データベースにアクセスする Data Movement gateway を選択します。 ユースケースに応じて、これはデータ ソースからデータを移動するために展開された、同じまたは別の Data Movement gateway になります。 Data Movement gateway のユース ケースに関する詳細については、「[どのようなときに Data Movement gateway が必要ですか？](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#top)」および「[一般的な使用例](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/replication-gateway.htm#Common)」を参照してください。 ターゲット データベースが Qlik Cloud から直接アクセスできる場合は、 [None] (なし) を選択します。 情報メモData Movement gateway 経由でターゲット データベースにアクセスする場合は、Data Movement gateway マシンに適切なドライバーをインストールする必要もあります。詳細については、以下の「[Microsoft Fabric](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/TargetConnections/fabric-target.htm#Driver)」を参照してください。 ### 接続プロパティ * サーバー: 使用している Microsoft Fabric Data Warehouse サーバーの名前。 ### アカウントのプロパティ 認証方法: 次のうち 1 つを選択します: * Azure Active Directory サービス プリンシパル 次に、指定された項目に [クライアント ID] と [クライアント シークレット] を入力します。 * Azure Active Directory ユーザー プリンシパル 次に、指定された項目に [ユーザー名] と [パスワード] を入力します。 ### データベースのプロパティ * データベース名: データベースを指定するには 2 つの方法があります。 * 方法 1 - リストから選択: [データベースをロード] をクリックし、データベースを選択します。 * 方法 2 - 手動: [データベース名を手動で入力] を選択し、データベース名を入力します。 ### データのロード * SAS トークン: Microsoft Fabric が ADLS ストレージ アカウントにアクセスするために使用する SAS トークン。これは、[既存のデータを登録する](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Onboarding/Registering-data.htm)場合は必要ありません。 ### 名前 接続の表示名。 ## 前提条件 ### データベース権限 Microsoft Fabric 設定の [ODBC アクセスコネクタ] セクションで指定された Azure Active Directory ユーザー/サービス プリンシパルには、共同制作者ロールが付与されている必要があります。 ### ドライバーのセットアップ ドライバーは、Data Movement gateway 経由でデータベースにアクセスする場合にのみ必要です。このような場合は、Data Movement gateway マシンにドライバーをインストールする必要があります。 driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。 #### ドライバー インストール ユーティリティを使用したドライバーのインストール このセクションでは、必要な driver のインストール方法を説明しました。このプロセスでは、必要な driver を自動的にダウンロード、インストール、設定するスクリプトを実行します。また、必要に応じて driver の更新やアンインストールを行うスクリプトを実行することもできます。 インストールの準備 * データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。 Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。 python3 --version driver のインストール driver をダウンロードしてインストールするには: 1. Data Movement gateway サービスを停止します。 sudo systemctl stop repagent 2. 必要に応じて、サービスが停止されたことを確認します。 sudo systemctl status repagent ステータスは次のようになっているはずです。 Active: inactive (dead) since <timestamp> ago 3. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します: opt/qlik/gateway/movement/drivers/bin 4. 次のコマンドを実行します: 構文: ./install fabric アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、install fabric コマンドを再度実行します。 それ以外の場合は、driver の EULA が表示されます。 5. 次のいずれかを実行します。 * 何度も [Enter] を押すと、EULA 全体をスクロールできます。 * 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。 * q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。 6. 次のいずれかを実行します。 * 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。 * 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。 * 「v」を入力して [Enter] を押すと、EULA が再表示されます。 driver がインストールされます。 7. インストールが終了するまで待ってから (「完了しました!」と表示されます)、Data Movement gateway サービスを開始します。 sudo systemctl start repagent 8. 必要に応じて、サービスが開始されたことを確認します。 sudo systemctl status repagent ステータスは次のようになっているはずです。 Active: active (running) since <timestamp> ago driver の更新 提供された driver をインストールする前に前のバージョンの driver をアンインストールしたい場合は、更新コマンドを実行します。 driver をダウンロードして更新するには: 1. Data Movement gateway サービスを停止します。 sudo systemctl stop repagent 2. 必要に応じて、サービスが停止されたことを確認します。 sudo systemctl status repagent ステータスは次のようになっているはずです。 Active: inactive (dead) since <timestamp> ago 3. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します: opt/qlik/gateway/movement/drivers/bin 4. 次のコマンドを実行します: 構文: ./update fabric アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、update fabric コマンドを再度実行します。 それ以外の場合は、driver の EULA が表示されます。 5. 次のいずれかを実行します。 * 何度も [Enter] を押すと、EULA 全体をスクロールできます。 * 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。 * q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。 6. 次のいずれかを実行します。 * 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。 * 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。 * 「v」を入力して [Enter] を押すと、最初から EULA をレビューできます。 古い driver がアンインストールされ、新しい driver がインストールされます。 7. インストールが終了するまで待ってから (「完了しました!」と表示されます)、Data Movement gateway サービスを開始します。 sudo systemctl start repagent 8. 必要に応じて、サービスが開始されたことを確認します。 sudo systemctl status repagent ステータスは次のようになっているはずです。 Active: active (running) since <timestamp> ago driver のアンインストール driver をアンインストールする場合は、アンインストール コマンドを実行します。 driver をアンインストールするには: 1. このコネクタを使用するように構成されているすべてのタスクを停止します。 2. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します: opt/qlik/gateway/movement/drivers/bin 3. 次のコマンドを実行します: 構文: ./uninstall fabric driver がアンインストールされます。 #### ドライバーの手動インストール 自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。 ODBC ドライバーと JDBC ドライバーの両方をインストールする必要があります。 ODBC ドライバーのインストール Data Movement gateway がインストールされたら、msodbcsql<バージョン>.x86\_64.rpmドライバーをダウンロードします。サポートされているバージョンへの直接ダウンロード リンクは、/opt/qlik/gateway/movement/drivers/manifests/fabric.yaml の binary-artifacts にあります。ダウンロードが完了したら、RPM を Data Movement gateway マシンにコピーします。 1. Data Movement gateway サービスを停止します。 sudo systemctl stop repagent 2. 必要に応じて、サービスが停止されたことを確認します。 sudo systemctl status repagent ステータスは次のようになっているはずです。 Active: inactive (dead) since <timestamp> ago 3. ドライバーを Data Movement gateway マシンにインストールします。 4. ドライバーの場所を `site_arep_login.sh` ファイルにコピーします: ``` echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql/lib64/" >> site_arep_login.sh ``` 例: ``` echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql17/lib64/" >> site_arep_login.sh ``` これにより、ドライバーが「LD\_LIBRARY\_PATH」に追加され、**site\_arep\_login.sh** ファイル内のドライバーの場所が更新されます。 5. 必要に応じて、ドライバーの場所がコピーされていることを確認します。 ``` cat site_arep_login.sh ``` 6. Data Movement gateway サービスを起動します。 sudo systemctl start repagent 7. オプションで、サービスが開始されたことを確認します。 sudo systemctl status repagent ステータスは次のようになっているはずです。 Active: active (running) since <timestamp> ago JDBC ドライバーのインストール 1. /opt/qlik/gateway/movement/drivers/manifests/fabric.yaml の binary-artifacts の下にリストされている JAR ファイルをダウンロードします。次に、ファイルを Data Movement gateway マシンの次のフォルダーにコピーします。 /opt/qlik/gateway/movement/qcs\_agents/qdi-db-commands/lib 2. Data Movement gateway で説明されているコマンドを実行して、[サービスの再起動](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/Gateways/dm-gateway-managing.htm#Restarti2) サービスを再起動します 警告メモMicrosoft SQL Server データ ソース (CDC ベースまたはログベース) を使用している場合、Fabric ドライバーをアンインストールすると、同じドライバーを共有しているため、SQL Server への接続も切断されます。 ### ポート アウトバウンド通信用にポート 1433 を開きます。 ## 制限と考慮事項 * 次の操作はサポートされていないため、ターゲットには適用されません。 * 列名の変更 * DROP/ALTER 列 * 新しく追加された列 (ADD COLUMN) は Null 可能である必要があります。 情報メモ Data Movement gatewayy 2026.5.1 以降、ターゲット データ型は `8000` ではなく `MAX` の長さにマッピングされます。登録済みデータ、ストレージ、変換、データ マート、ナレッジ マート タスクの既存の列にマッピングを適用するには、`ALTER TABLE` を実行して列のデータ型を変更するか、テーブルを再作成します。その他のタスク タイプについては、テーブルを再作成してください。 ## データ型。 次の表は、Microsoft Fabric の使用時に対応する Qlik Cloud データ型と、Qlik Cloud データ型からの初期設定のマッピングを示しています。 ネイティブ データ タイプの情報は保持され、データセット ビューの [ネイティブ データ タイプ] 列に表示されます。列が表示されない場合は、データ セット ビューの列ピッカーを開いて、 [ネイティブ データ タイプ] 列を選択する必要があります。 対応しているデータ型 | Qlik Talend Data Integration データ型 | Microsoft Fabric データ型 | | --- | --- | | BOOL | BIT | | BYTES | 長さが 1 ～ 8000 の場合:

VARBINARY (バイト長)

長さが 8000 バイトを超える場合、BYTES は VARBINARY (MAX) にマッピングされます。 | | DATE | DATE | | TIME | スケールが 0 ～ 6 の場合:

TIME (スケール)

スケールが 6 を超える場合:

TIME (6) | | TIMESTAMP | スケールが 0 ～ 6 の場合:

DATETIME2 (Scale)

スケールが 6 を超える場合:

DATETIME2 (6) | | INT1 | SMALLINT | | INT2 | SMALLINT | | INT4 | INT | | INT8 | BIGINT | | NUMERIC | DECIMAL (p,s) | | REAL4 | FLOAT(24) | | REAL8 | FLOAT(53) | | STRING | バイト長が 1 ～ 8000 の場合:

VARCHAR (長さのバイト数)

バイト単位の長さが 8000 を超える場合、STRING は VARCHAR (MAX) にマッピングされます。 | | UINT1 | SMALLINT | | UINT2 | INT | | UINT4 | BIGINT | | UINT8 | DECIMAL (20,0) | | WSTRING | バイト長が 1 ～ 8000 の場合:

VARCHAR (長さのバイト数)

バイト単位の長さが 8000 を超える場合、WSTRING は VARCHAR (MAX) にマッピングされます。 | | BLOB | VARBINARY (max) | | NCLOB | VARCHAR (最大) | | CLOB | VARCHAR (最大) | | JSON | VARCHAR (最大) | 情報メモ完全な LOB データ型はサポートされていません。サイズ制限のある LOB データ型を 移動 に含める方法については、「[データ ソースからのランディング データ](https://help.qlik.com/ja-JP/cloud-services/Subsystems/Hub/Content/Sense_Hub/DataIntegration/Landing/Landing-data-data-sources.htm#Runtime)」を参照してください。