Microsoft Fabric
Microsoft Fabric データ パイプラインまたはレプリケーション タスクのターゲット データ プラットフォームとして。データ パイプラインでは、データの保存、データの変換、データ マートの作成、データの登録など、さまざまな ELT 操作をターゲット プラットフォーム上で実行できます。一方、レプリケーション タスクでは、基本的な変換機能を備え、ソース システムからターゲット システムへ直接データをレプリケートしますが、ELT 操作はサポートしません。 を使用できます
Microsoft Fabric をターゲットとして設定するには、次が必要です。
- 前提条件を満たす
- クラウド ステージング エリア (Azure Data Lake Storage) への接続を構成する。これは、既存のデータを登録する場合は必要ありません。
- Microsoft Fabric への接続を構成する
クラウド ステージング エリアの設定
また、データと変更が適用および保存される前にステージングされる Azure Data Lake Storage クラウド ステージング エリアも必要です。Azure Data Lake Storage への接続の設定については、「Azure Data Lake Storage」を参照してください。
Microsoft Fabric 接続プロパティの設定
Azure Data Lake Storage ターゲット設定を指定したら、次の操作を行います。
-
Microsoft Fabric ターゲット コネクタを選択し、次の設定を行います。
データ ターゲット
データ ゲートウェイ
Data Movement gateway は、ターゲット データベースが Qlik Cloud からアクセスできない場合にのみ必要で、プライベート リンクを使用してのみアクセスできます ( Virtual Private Cloud にある場合など) 。該当する場合には、ターゲット データベースにアクセスする Data Movement gateway を選択します。
ユースケースに応じて、これはデータ ソースからデータを取得するために展開された、同じまたは別の Data Movement gateway になります。
Data Movement gateway 展開の可能性については、「 一般的なユース ケース」を参照してください。
ターゲット データベースが Qlik Cloud から直接アクセスできる場合は、 [None] (なし) を選択します。
接続プロパティ
- サーバー: 使用している Microsoft Fabric Data Warehouse サーバーの名前。
アカウントのプロパティ
認証方法: 次のうち 1 つを選択します:
-
Azure Active Directory サービス プリンシパル
次に、指定された項目に [クライアント ID] と [クライアント シークレット] を入力します。
-
Azure Active Directory ユーザー プリンシパル
次に、指定された項目に [ユーザー名] と [パスワード] を入力します。
データベースのプロパティ
-
データベース名: データベースを指定するには 2 つの方法があります。
- 方法 1 - リストから選択: [Load databases] (データベースをロード) をクリックし、データベースを選択します。
- 方法 2 - 手動: [Enter database name manually] (データベース名を手動で入力) を選択し、データベース名を入力します。
データのロード
-
SAS トークン: Microsoft Fabric が ADLS ストレージ アカウントにアクセスするために使用する SAS トークン。これは、既存のデータを登録する場合は必要ありません。
名前
接続の表示名です。
前提条件
データベース権限
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 をダウンロードしてインストールするには:
-
Data Movement gateway サービスを停止します。
sudo systemctl stop repagent
-
オプションで、サービスが停止されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: inactive (dead) since <timestamp> ago
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./install fabric
アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、install fabric コマンドを再度実行します。
それ以外の場合は、driver の EULA が表示されます。
-
以下のいずれかを行います。
- 何度も [Enter] を押すと、EULA 全体をスクロールできます。
- 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。
- q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。
-
以下のいずれかを行います。
- 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
- 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
-
「v」を入力して [Enter] を押すと、EULA が再表示されます。
-
インストールが終了するまで待ってから (「完了しました!」と表示されます)、Data Movement gateway サービスを開始します。
sudo systemctl start repagent
-
必要に応じて、サービスが開始されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: active (running) since <timestamp> ago
driver がインストールされます。
driver の更新
提供された driver をインストールする前に前のバージョンの driver をアンインストールしたい場合は、更新コマンドを実行します。
driver をダウンロードして更新するには:
-
Data Movement gateway サービスを停止します。
sudo systemctl stop repagent
-
オプションで、サービスが停止されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: inactive (dead) since <timestamp> ago
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./update fabric
アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、update fabric コマンドを再度実行します。
それ以外の場合は、driver の EULA が表示されます。
-
以下のいずれかを行います。
- 何度も [Enter] を押すと、EULA 全体をスクロールできます。
- 何度もスペースバーを押して、EULA 全体をスピーディにスクロールします。
- q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。
-
以下のいずれかを行います。
- 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
- 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
- 「v」を入力して [Enter] を押すと、最初から EULA をレビューできます。
-
インストールが終了するまで待ってから (「完了しました!」と表示されます)、Data Movement gateway サービスを開始します。
sudo systemctl start repagent
-
必要に応じて、サービスが開始されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: active (running) since <timestamp> ago
古い driver がアンインストールされ、新しい driver がインストールされます。
driver のアンインストール
driver をアンインストールする場合は、アンインストール コマンドを実行します。
driver をアンインストールするには:
-
このコネクタを使用するように構成されているすべてのタスクを停止します。
-
データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:
opt/qlik/gateway/movement/drivers/bin
-
次のコマンドを実行します。
構文:
./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 マシンにコピーします。
-
Data Movement gateway サービスを停止します。
sudo systemctl stop repagent
-
必要に応じて、サービスが停止されたことを確認します。
sudo systemctl status repagent
-
ドライバーを Data Movement gateway マシンにインストールします。
-
ドライバーの場所を
site_arep_login.sh
ファイルにコピーします:echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/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 ファイル内のドライバー場所が更新されます。
-
オプションで、ドライバーの場所がコピーされていることを確認します。
cat site_arep_login.sh
-
Data Movement gateway サービスを起動します。
sudo systemctl start repagent
-
オプションで、サービスが開始されたことを確認します。
sudo systemctl status repagent
ステータスは次のようになっているはずです。
Active: active (running) since <timestamp> ago
ステータスは次のようになっているはずです。
Active: inactive (dead) since <timestamp> ago
JDBC ドライバーのインストール
-
/opt/qlik/gateway/movement/drivers/manifests/fabric.yaml の binary-artifacts の下にリストされている JAR ファイルをダウンロードします。次に、ファイルを Data Movement gateway マシンの次のフォルダーにコピーします。
/opt/qlik/gateway/movement/qcs_agents/qdi-db-commands/lib
-
サービスの再起動 で説明されているコマンドを実行して、Data Movement gateway サービスを再起動します
ポート
アウトバウンド通信用にポート 1433 を開きます。
制限と考慮事項
次の操作はサポートされていないため、ターゲットには適用されません。
- テーブルの切り捨て
- 列名の変更
- 列の追加/ドロップ/変更
BLOB 列と BYTES 列はサポートされていません。ソース テーブルにこれらのデータ型の列が含まれている場合は、変換を使用してそれらを STRING に変換するか、レプリケーションから除外することができます。
データ型
次の表は、Qlik Cloud の使用時に対応する Microsoft Fabric データ型と、Qlik Cloud データ型からの初期設定のマッピングを示しています。
ネイティブ データ タイプの情報は保持され、データセット ビューの [ネイティブ データ タイプ] 列に表示されます。列が表示されない場合は、データ セット ビューの列ピッカーを開いて、 [ネイティブ データ タイプ] 列を選択する必要があります。
Data Movement gateway データ型 | Microsoft Fabric データ型 |
---|---|
BOOL |
BIT |
BYTES |
長さが 1 ~ 8000 の場合: VARBINARY (長さのバイト数) 長さが 8000 を超える場合: VARBINARY (8000) |
DATE |
DATE |
TIME |
スケールが 0 ~ 6 の場合: TIME (スケール) スケールが 6 を超える場合: TIME (6) |
DATETIME |
スケールが 0 ~ 6 の場合: DATETIME2 (スケール) スケールが 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 を超える場合: VARCHAR (8000) |
UINT1 |
SMALLINT |
UINT2 |
INT |
UINT4 |
BIGINT |
UINT8 |
DECIMAL (20,0) |
WSTRING |
長さのバイト数が 1 ~ 8000 の場合: VARCHAR (長さのバイト数) 長さのバイト数が 8000 を超える場合: VARCHAR (8000) |
BLOB |
VARCHAR (8000) |
NCLOB |
VARCHAR (8000) |
CLOB |
VARCHAR (8000) |