メイン コンテンツをスキップする 補完的コンテンツへスキップ
Qlik リソース

前提条件

データのランディングまたはレプリケートをする前に、次の前提条件を満たすようにします。

  • Data Movement ゲートウェイ サーバーに、必要なdriverをインストールする

  • データ ソースに必要な権限を付与する

  • データ ソースのコネクタを構成する

ドライバーのセットアップ

driver のインストールは、ドライバー インストール ユーティリティを使用する (推奨) か、手動で実行できます。手動インストールは、ドライバー インストール ユーティリティで問題が発生した場合にのみ実行するようにしてください。

ドライバー インストール ユーティリティを使用したドライバーのインストール

このセクションでは、必要な driver のインストール方法を説明しました。このプロセスでは、必要な driver を自動的にダウンロード、インストール、設定するスクリプトを実行します。また、必要に応じて driver の更新やアンインストールを行うスクリプトを実行することもできます。

インストールの準備

  • データ移動 ゲートウェイ サーバーに Python 3.6.x 以降 がインストールされていることを確認します。

    Python は、ほとんどの Linux 配布に前もってインストールされています。お使いのシステムにインストールされている Python のバージョンは、次のコマンドを実行することで確認できます。

    python3 --version

driver のインストール

driver をダウンロードしてインストールするには:

  1. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

    opt/qlik/gateway/movement/drivers/bin

  2. 次のコマンドを実行します。

    構文:

    ./install sqlserver

    アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、install sqlserver コマンドを再度実行します。

    それ以外の場合は、driver の EULA が表示されます。

  3. 以下のいずれかを行います。

    • 何度も [Enter] を押すと、EULA 全体をスクロールできます。
    • 何度もスペースバーを押すと、EULA 全体をスピーディにスクロールできます。
    • q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。

  4. 以下のいずれかを行います。

    • 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
    • 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。

    • 「v」を入力して [Enter] を押すと、EULA が再表示されます。

    5. driver がインストールされます。

driver の更新

提供された driver をインストールする前に前のバージョンの driver をアンインストールしたい場合は、更新コマンドを実行します。

driver をダウンロードして更新するには:

  1. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

    opt/qlik/gateway/movement/drivers/bin

  2. 次のコマンドを実行します。

    構文:

    ./update sqlserver

    アクセス制限または技術的な問題により driver をダウンロードできない場合は、driver をダウンロードする場所と データ移動 ゲートウェイ マシンのコピー先を指示するメッセージが表示されます。それが完了したら、update sqlserver コマンドを再度実行します。

    それ以外の場合は、driver の EULA が表示されます。

  3. 以下のいずれかを行います。

    • 何度も [Enter] を押すと、EULA 全体をスクロールできます。
    • 何度もスペースバーを押して、EULA 全体をスピーディにスクロールします。
    • q を押すと、ライセンス テキストが終了し、EULA 受諾オプションが表示されます。

  4. 以下のいずれかを行います。

    • 「y」を入力して [Enter] を押すと、EULA が受諾され、インストールが開始します。
    • 「n」を入力して [Enter] を押すと、EULA が拒否され、インストールが終了します。
    • 「v」を入力して [Enter] を押すと、最初から EULA をレビューできます。

    5. 古い driver がアンインストールされ、新しい driver がインストールされます。

driver のアンインストール

driver をアンインストールする場合は、アンインストール コマンドを実行します。

driver をアンインストールするには:

  1. このコネクタを使用するように構成されているすべてのタスクを停止します。

  2. データ移動 ゲートウェイ マシンで、作業ディレクトリを次に変更します:

    opt/qlik/gateway/movement/drivers/bin

  3. 次のコマンドを実行します。

    構文:

    ./uninstall sqlserver

    driver がアンインストールされます。

ドライバーの手動インストール

自動ドライバーのインストールが正常に完了しなかった場合にのみ、driver を手動でインストールするようにしてください。

データ移動ゲートウェイ がインストールされたら、msodbcsql<バージョン>.x86_64.rpmドライバーをダウンロードします。サポートされているバージョンへの直接ダウンロード リンクは、/opt/qlik/gateway/movement/drivers/manifests/sqlserver.yaml の binary-artifacts にあります。ダウンロードが完了したら、RPM を データ移動ゲートウェイ マシンにコピーします。

Data Movement gateway サーバーで、シェル プロンプトを開き、次の手順を実行します。

  1. Data Movement gateway サービスを停止します。

    sudo systemctl stop repagent

  2. オプションで、サービスが停止されたことを確認します。

    sudo systemctl status repagent

    3. ステータスは次のようになっているはずです。

    Active: inactive (dead) since <timestamp> ago

  3. ドライバー (RPM) をインストールします。

  4. 作業ディレクトリを <product_dir>/bin に変更します。

  5. ドライバーの場所を site_arep_login.sh ファイルにコピーします:

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

    これにより、ドライバーが「LD_LIBRARY_PATH」に追加され、 site_arep_login.sh ファイル内のドライバー場所が更新されます。

  6. オプションで、ドライバーの場所がコピーされていることを確認します。

    cat site_arep_login.sh

  7. Data Movement gateway サービスを起動します。

    sudo systemctl start repagent

  8. オプションで、サービスが開始されたことを確認します。

    sudo systemctl status repagent

    ステータスは次のようになっているはずです。

    Active: active (running) since <timestamp> ago

  9. Data Movement gateway は次の ODBC ライブラリを必要とします: msodbcsql-18.1.so.1.1

    現在インストールされているライブラリのバージョンを確認するには、次のコマンドを発行します。

    ls /opt/microsoft/msodbcsql<version>/lib64/

    既存のライブラリのバージョン番号が異なる場合 (例: libmsodbcsql-18.0.so.1.1)、既存のライブラリと必要なライブラリの間にシンボリック リンクを作成する必要があります。

    これを行うには、次のコマンドを発行します。

    cd /opt/microsoft/msodbcsql<version>/lib64/
    ln -s existing_library_name msodbcsql-18.1.so.1.1

    existing_library_name は現在インストールされているライブラリの名前です (例: libmsodbcsql-18.0.so.1.1)。

警告メモMicrosoft Fabric ターゲットを使用している場合、Microsoft ODBC Driver for SQL Server ドライバーをアンインストールすると、同じドライバーを共有しているため、Microsoft Fabric への接続も切断されます。

データベースの選択

データベースを選択できるようにする (コネクタ ダイアログで [Load databases] (データベースをロード) をクリック) には、コネクタ設定で指定したユーザーをマスター データベース上に作成する必要があります。

ポート

既定では、Data Movement gatewayサーバーのアウトバウンド通信のために、ポート 1434 を開く必要があります。これは、コネクタ設定で変更できます。

CDC 用データベースの準備

次のセクションでは、CDC に対してデータベースを設定する方法が説明されています。

CDC に対してデータベースを設定するには:

  1. 次を実行することにより、MS-CDC に対してデータベースを設定します:

    exec source_db_name.dbo.sp_cdc_enable_db

    source_db_name はソース データベースの名前です。

  2. landing タスクにより、すべてのソース テーブルに対して自動的に MS-CDC が有効化されます。ただし、手動で MS-CDC を有効にしたい場合は、次のスクリプトを実行します (対象となるソース テーブルそれぞれに対して):

    exec sys.sp_cdc_enable_table

    @source_schema = N'schema_name',

    @source_name = N'table_name',

    @role_name = NULL

    schema_name と table_name は、それぞれソース スキーマとソース テーブルの名前です。

    情報メモ
    • CT テーブル名では既定の命名形式を使用する必要があります: <SchemaName>_<TableName>_CT

    • CT テーブルには次の列が含まれている必要があります: [__$start_lsn]、[__$end_lsn]、[__$seqval]、[__$operation]、[__$update_mask]、<all the data columns>、[__$command_id]

  3. MS-CDC キャプチャとクリーンアップ ジョブが実行中であることを確認します。

    情報メモ
    • sys.sp_cdc_change_job を使用してジョブをコントロールできます。その他の情報については、Microsoft Help を参照してください。
    • 遅延を短縮するために、@pollinginterval パラメータを小さな値に設定することが推奨されます。

このページは役に立ちましたか?

このページまたはコンテンツに、タイポ、ステップの省略、技術的エラーなどの問題が見つかった場合は、お知らせください。改善に役立たせていただきます。

こちらにフィードバックをお寄せください