ODBCのソース・ターゲットエンドポイントとしての利用

© 2019 QlikTech International AB. All rights reserved.
ODBCの
ソース・ターゲットエンドポイント
としての利用
クリックテック・ジャパン株式会社

© 2019 QlikTech International AB. All rights reserved.
2
Using ODBC to
connect to a source

3
ODBCを使用したソースへの接続
ODBCを使用したソースへの接続
このセクションでは、ODBC 接続を使用してソースエンドポイントに接続する方法について説明します。
手記：ODBC ソースエンドポイントを使用して、Qlik Replicateの広範なサポートマトリックスに含まれていないソースにアク
セスできます。ただし、プロフェッショナルサービスを通じて有効にし、アカウントマネージャーによって承認されない限り、ODBC
ソースエンドポイントは使用しないでください。また、ODBC ソースエンドポイントは、サポートマトリックスに既にリストされている
ソースにアクセスするために使用しないでください。
このセクションでは、次の手順を実行します。
• 前提条件
• 制限事項
• ODBC ソースデータ型
• 一般的な接続プロパティの設定
• 高度な接続プロパティの設定

4
前提条件：Qlik Replicate server for Windows
エンドポイントを、ODBC を使用してQlik レプリケートに接続するには、DSN (データソース名) を指定します。この場合、Qlik Replicateがイン
ストールされているコンピューター上の ODBC エンドポイントに DSN が定義されていることを確認する必要があります。
1. Qlik Replicateがインストールされているコンピューターにエンドポイントクライアントをインストールします。インストールするクライアントは、使用
している ODBC プロバイダーによって異なります。例えば、IBM DB2 エンドポイントを使用している場合は、IBM DB2 クライアントをインス
トールします。
手記：Qlik レプリケートを使用するには、64 ビット ODBC プロバイダクライアントを使用する必要があります。
2. ODBC データソースアドミニストレータを使用して、システム DSN を作成します。データソースは、Windowsのコントロールパネルにあります。

5
前提条件：Qlik Replicate server for Linux
次のセクションでは、Qlikレプリケートタスクのソースエンドポイントとして、Linux 用Qlik レプリケートと ODBC を使用するために実行する必要があ
る手順について説明します。
1.Qlik レプリケートサーバーマシンで、使用する ODBC クライアント (例: postgreSQL) をインストールします。
2.次の例に示すように、/etc/odbcinst.iniファイルにインストールしたドライバの正しいエントリが含まれていることを確認します。
[PostgeSQL]
Description = ODBC for PostgreSQL
Driver = /usr/lib/psqlodbc.so
Setup = /usr/lib/libodbcpsqlS.so
Driver64 = /usr/lib64/psqlodbc.so
Setup64 = /usr/lib64/libodbcpsqlS.so
FileUsage = 1
手記：
ODBC を使用して IBM DB2 for LUW ターゲットにアクセスするには、libdb2o.soドライバー (libdb2.soではなく) を指定してください。
3.次の例のように、/etc/odbc.iniファイルを編集して、インストールされているドライバーの DSN を定義します。
[Postgre_DSN]
Description = Test
Driver = /usr/lib64/psqlodbc.so
Endpoint = MyDatabase
Servername = 12.3.45.678
Port = 5432

6
制限事項
ODBC をソースとして使用する場合、次の制限が適用されます。
• 主キーフィールドへの更新はサポートされていません。フィールドを更新するには、フィールドを一意のインデックスとして定義します。
• ODBC ソースエンドポイントは、フルロード操作のみをサポートします。
• バッチ操作をサポートしないプロバイダの場合は、「内部パラメータ(Internal Parameters)」に記載されている説明に従って
RowByRow=true 内部パラメータを設定する必要があります。

7
ODBCソースデータ型
次の表は、Qlik レプリケートを使用する場合にサポートされる ODBC ソースデータ型と、Qlik Replicateデータ型からの既定のマッピングを示していま
す。
ターゲットにマップされているデータ型を表示する方法については、使用しているターゲットエンドポイントのセクションを参照してください。
Qlik レプリケートデータ型の詳細については、「データ型のレプリケート」を参照してください。
ODBC データ型 Qlik レプリケートデータ型
SQL_BIT ブーリアン
SQL_TINYINT
INT1
UINT1
SQL データ型は、マップ対象のデータ型に対してUNSIGNED_ATTRIBUTEがSQL_TRUEに設定されている場合、
符号なしデータ型にマップされます。
SQL_SMALLINT
INT2
UINT2
SQL_INTEGER
INT4
UINT4
SQL_BIGINT
INT8
UINT8
SQL_DOUBLE REAL8
SQL_FLOAT REAL8
SQL_REAL REAL8
SQL_NUMERIC (P,S)
NUMERIC (P,S)
REAL8
SQL_NUMERICデータ・タイプは、以下の少なくとも 1 つが真の場合に REAL8 にマップされます。
Precision > 38
Scale < 0
Scale > 38
Scale > Precision
SQL_DECIMAL (P,S)
NUMERIC (P,S)
REAL 8
SQL_NUMERICデータ・タイプは、以下の少なくとも 1 つが真の場合に REAL8 にマップされます。
Precision > 38
Scale < 0
Scale > 38
Scale > Precision

8
ODBCソースデータ型
SQL_DATE
SQL_TYPE_DATE
DATE
SQL_TIME
SQL_TYPE_TIME
TIME
SQL_TIMESTAMP
SQL_TYPE_TIMESTAMP
DATETIME
SQL_CHAR
SQL_VARCHAR
STRING
SQL_WCHAR
SQL_WVARCHAR
WSTRING
SQL_LONGVARCHAR
手記：
Qlik Replicateでこのデータ型を使用するには、特定のタ
スクに対して CLOB を使用できるようにする必要がありま
す。
CDC 中または [無制限のLOB サイズを許可する] オプ
ションが有効になっている場合のフルロード中は、LOB
データ型は主キーを持つテーブルでのみサポートされます。
CLOB
SQL_WLONGVARCHAR
手記：
このデータ型をQlik Replicateで使用するには、特定のタ
スクに対して NCBLOB の使用を有効にする必要がありま
す。
CDC 中または [無制限のLOB サイズを許可する] オプ
ションが有効になっている場合のフルロード中は、LOB
データ型は主キーを持つテーブルでのみサポートされます。
NCLOB
SQL_BINARY BYTES
SQL_LONGVARBINARY
手記：
このデータ型をQlik Replicateで使用するに
は、特定のタスクに対して BLOB の使用を有
効にする必要があります。
CDC 中または [無制限のLOB サイズを許
可する] オプションが有効になっている場合の
フルロード中は、LOB データ型は主キーを持
つテーブルでのみサポートされます。
BLOB
SQL_GUID STRING
SQL_INTERVAL_YEAR
SQL_INTERVAL_MONTH
SQL_INTERVAL_DAY
SQL_INTERVAL_MINUTE
SQL_INTERVAL_HOUR
SQL_INTERVAL_SECOND
SQL_INTERVAL_YEAR_TO_MONTH
SQL_INTERVAL_DAY_TO_HOUR
SQL_INTERVAL_DAY_TO_MINUTE
SQL_INTERVAL_DAY_TO_SECOND
SQL_INTERVAL_HOUR_TO_MINUTE
SQL_INTERVAL_HOUR_TO_SECON
D
SQL_INTERVAL_MINUTE_TO_SECO
ND
STRINGw
プロバイダー固有のデータ型
手記：
列の長さが 0 または > 4000 の場合は、次
のようになります。
このデータ型をQlik Replicateで使用するに
は、特定のタスクに対して BLOB の使用を有
効にする必要があります。
CDC 中または [無制限のLOB サイズを許
可する] オプションが有効になっている場合の
フルロード中は、LOB データ型は主キーを持
つテーブルでのみサポートされます。
列の長さが<または = 4000 の場合:
BYTES
列の長さが 0 または > 4000 の場合は、次のようになります。
BLOB

9
一般的な接続プロパティの設定
ここでは、一般的な接続プロパティを構成する方法について説明します。詳細な接続プロパティを構成する方法については、接続のSetting advanced
connection propertiesを参照してください。
ODBC ソースエンドポイントをQlik レプリケートに追加するには、次の手順を実行します。
1.Qlik レプリケートコンソールで、[Manage Endpoint Connections] をクリックして[Manage Endpoint Connections] ダイアログボックスを開きます。次に、
[New Endpoint Connection] ボタンをクリックします。
2.[Name]フィールドに、ODBC エンドポイントの名前を入力します。使用するエンドポイントを識別するのに役立つ任意の名前を指定できます。
3.[Description ]フィールドに、ODBC エンドポイントを識別するための説明を入力します。これはオプションです。
4.エンドポイントroleとして[Source] を選択します。
5.エンドポイントのTypeとしてODBCを選択します。
6.次のいずれかを選択します。
• 使用する DSN が一覧に含まれていない場合は、エンドポイントクライアントがQlik Replicateを使用してコンピュータにインストールされていること、お
よび DSN が定義されていることを確認します。ODBC プロバイダークライアントは 64 ビットである必要があります。詳細については、「前提条件」を参
照してください。
手記：Qlik レプリケートタスクのソースとしてARC CDC エージェントを使用している場合、ターゲットとしてQlik ODBC ドライバーの DSN を選択す
ることはできません。この場合、Qlik ODBC をソースとして使用するには、Connection Stringを選択し、この手順のオプションの指示に従って接続
文字列を手動で入力する必要があります。
• Connection String: 接続文字列を使用して ODBC でサポートされるエンドポイントに接続するには、このオプションを選択し、次のフィールドに有効な
接続文字列を入力します。接続文字列の作成方法については、使用している ODBC エンドポイントプロバイダーのドキュメントを参照してください。
接続文字列にパスワードを指定すると、タスクログファイルにプレーンテキストとして表示されます。そのため、GUIパスワードフィールドにパスワードを
指定することをお勧めします。

10
7. 使用する ODBC エンドポイントの認証ユーザーの認証情報 (User Name、Password) を入力します。例えば、IBM DB2 プロバイ
ダーを使用している場合は、IBM DB2 システム管理者が使用します。この情報がわからない場合は、ODBC エンドポイントシステムアドミ
ニストレータを参照してください。
手記：[Connection String] を選択する場合は、入力した接続文字列にUser NameとPasswordの情報を必ず入力してください。
[Advanced] タブを使用してカスタム文字列を作成する場合は、必ず[User Name] プロパティと[Password] プロパティを含めます。
詳細については、接続の詳細プロパティの設定を参照してください。
この情報は大文字と小文字を区別します。
[Advanced] タブでカスタムプロパティを設定できます。詳細については、接続の詳細プロパティの設定を参照してください。
手記：ODBC エンドポイントユーザーが、使用している ODBC プロバイダーに対して正しいアクセス権限を持っていることを確認します。

11
高度な接続プロパティの設定
[Advanced ] タブでは、次のプロパティを設定できます。
• Provider syntax : 別のプロバイダー構文を使用している場合は、プロバイダー構文の名前を選択します。
Internal Parameters
Internal Parametersは、UI で公開されないパラメーターです。Qlikサポートの指示がある場合にのみ使用してください。
内部Qlik レプリケートパラメータを追加するには、次の手順を実行します。
1. [ Internal Parameters]リンクをクリックします。
2. [ Internal Parameters]ダイアログボックスが開きます。
3. 編集ボックスに、追加するパラメータの名前を入力し、クリックします。
4. パラメータは、デフォルト値を持つ検索ボックスの下のテーブルに追加されます。
5. 必要に応じて既定値を変更します。
6. パラメータ値をデフォルトにリセットするには、行の最後にある「既定値に戻す」アイコンをクリックします。
More Options
これらのオプションは、特定のバージョンまたは環境にのみ関連するため、UI では公開されません。したがって、Qlikサポートまたは製品マニュアルで明示的
に指示がない限り、これらのオプションを設定しないでください。
オプションを設定するには、オプションを [Add feature name]フィールドにコピーし、[Add] をクリックします。次に、値を設定するか、受信した指示に
従ってオプションを有効にします。
Setting Summary
設定の概要を表示するには、[Setting Summary]リンクをクリックします。これは、Qlikサポートに設定の概要を送信する必要がある場合に便利で
す。

12
Using ODBC to
connect to a target

13
ODBCを使用したターゲットへの接続
このトピックでは、ODBC 接続を使用してターゲットエンドポイントに接続する方法について説明します。
手記：ODBC ターゲットエンドポイントを使用して、Qlik Replicateの広範なサポートマトリックスに含まれていないターゲットにアクセスできます。
ただし、プロフェッショナルサービスを通じて有効にし、アカウントマネージャーによって承認されていない限り、ODBC ターゲットエンドポイントは使
用しないでください。また、ODBC ターゲットエンドポイントは、サポートマトリックスに既にリストされているターゲットにアクセスするために使用しな
いでください。
手記：HP ノンストップ SQL/MP (ARC) を ODBC ターゲットとして使用する場合は、追加の手順をいくつか実行する必要があります。詳細な
説明については、HP ノンストップ SQL/MP を ODBC ターゲットとして使用するを参照してください。
このセクションでは、次の手順を実行します。
•前提条件
•ODBC ターゲットデータ型
•一般的な接続プロパティの設定
•高度な接続プロパティの設定

14
前提条件：Qlik Replicate server for Windows
エンドポイントを、ODBC を使用してQlik レプリケートに接続するには、DSN (データソース名) を指定します。この場合、Qlik Replicateがイン
ストールされているコンピューター上の ODBC エンドポイントに DSN が定義されていることを確認する必要があります。
• Qlik Replicateがインストールされているコンピューターにエンドポイントクライアントをインストールします。インストールするクライアントは、使用し
ている ODBC プロバイダーによって異なります。例えば、IBM DB2 エンドポイントを使用している場合は、IBM DB2 クライアントをインストー
ルします。
手記：Qlik レプリケートを使用するには、64 ビット ODBC プロバイダクライアントを使用する必要があります。
• ODBC データソースアドミニストレータを使用して、システム DSN を作成します。データソースは、Windowsのコントロールパネルにあります。

15
前提条件：Qlik Replicate server for Linux
次のセクションでは、Qlikレプリケートタスクのソースエンドポイントとして、Linux 用Qlik レプリケートと ODBC を使用するために実行する必要があ
る手順について説明します。
1.Qlik レプリケートサーバーマシンで、使用する ODBC クライアント (例: postgreSQL) をインストールします。
2.次の例に示すように、/etc/odbcinst.iniファイルにインストールしたドライバの正しいエントリが含まれていることを確認します。
[PostgeSQL]
Description = ODBC for PostgreSQL
Driver = /usr/lib/psqlodbc.so
Setup = /usr/lib/libodbcpsqlS.so
Driver64 = /usr/lib64/psqlodbc.so
Setup64 = /usr/lib64/libodbcpsqlS.so
FileUsage = 1
手記：
ODBC を使用して IBM DB2 for LUW ターゲットにアクセスするには、libdb2o.soドライバー (libdb2.soではなく) を指定してください。
3.次の例のように、/etc/odbc.iniファイルを編集して、インストールされているドライバーの DSN を定義します。
[Postgre_DSN]
Description = Test
Driver = /usr/lib64/psqlodbc.so
Endpoint = MyDatabase
Servername = 12.3.45.678
Port = 5432

16
ODBCターゲットデータ型
次の表は、Qlik レプリケートを使用する場合にサポートされる ODBC ターゲットデータ型と、Qlik Replicateデータ型からの既定のマッピングを示しています。
手記：ODBC は、 Batch optimized applyモードでのバイナリデータ型への変更の適用をサポートしていません。 Batch optimized applyモードの詳細に
ついては、「変更処理のチューニング」を参照してください。
ソースからマップされるデータ型を表示する方法については、使用しているソースエンドポイントのセクションを参照してください。
Qlik レプリケートデータ型の詳細については、「データ型のレプリケート」を参照してください。
Qlik レプリケートデータ型 ODBC データ型
BOOLEAN SQL_BIT
BYTES SQL_VARBINARY
DATE SQL_TYPE_DATE
TIME SQL_TYPE_TIME
DATETIME SQL_TYPE_TIMESTAMP
INT1 SQL_SMALLINT
INT2 SQL_SMALLINT
INT4
ターゲットエンドポイントが精度とスケールをサポー
トしている場合は、次のようになります。
SQL_INTEGER
それ以外：
SQL_VARCHAR
Qlik レプリケートデータ型 ODBC データ型
INT8 SQL_BIGINT
NUMERIC SQL_NUMBER
REAL4 SQL_REAL
REAL8 SQL_DOUBLE
STRING SQL_VARCHAR
UINT1 SQL_TINYINT
UINT2 SQL_SMALLINT
UINT4 SQL_INTEGER
UINT8 SQL_BIGINT
WSTRING SQL_WVARCHAR
CLOB CLOB
BLOB BLOB

17
ここでは、一般的な接続プロパティを構成する方法について説明します。詳細な接続プロパティを構成する方法については、接続のSetting advanced
connection propertiesを参照してください。
ODBC エンドポイントをQlik レプリケートに追加するには、
1. Taskビューで、[Manage Endpoint Connections] をクリックして、[Manage Endpoint Connections] ダイアログボックスを開きます。次に、[New
Endpoint Connection] ボタンをクリックします。
2. [Name]フィールドに、ODBC エンドポイントの名前を入力します。使用するエンドポイントを識別するのに役立つ任意の名前を指定できます。
3. [Description]フィールドに、ODBC エンドポイントを識別するための説明を入力します。これはオプションです。
4. エンドポイントroleとして[Target] を選択します。
5. エンドポイントのTypeとしてODBCを選択します。
6. 次のいずれかを選択します。
• DSN: DSN を使用して ODBC でサポートされているエンドポイントに接続する場合に選択します。DSN を選択する場合は、使用している DSN を
リストから選択する必要があります。
手記：SQL/MP に接続する場合は、接続文字列を使用する必要があります。例については、接続文字列を参照してください。
使用する DSN が一覧に含まれていない場合は、エンドポイントクライアントがQlik Replicateを使用してコンピュータにインストールされていること、
および DSN が定義されていることを確認します。ODBC プロバイダークライアントは 64 ビットである必要があります。詳細については、「前提条件」
を参照してください。
手記：レプリケートタスクのソースとしてARC CDC エージェントを使用している場合、ターゲットとしてQlik ODBC ドライバーの DSN を選択すること
はできません。この場合、Qlik ODBC をターゲットとして使用するには、 Connection Stringを選択し、この手順でそのオプションの指示に従って接続
続文字列を手動で入力する必要があります。

18
• Connection String: 接続文字列を使用して ODBC でサポートされるエンドポイントに接続するには、このオプションを選択し、次のフィールドに有効
な接続文字列を入力します。接続文字列の作成方法については、使用している ODBC エンドポイントプロバイダーのドキュメントを参照してください。
SQL/MP 接続文字列の例:
Driver={Qlik Replicate ARC ODBC Driver
3.5 (Unicode)};BindUrl=attconnect://ais_server_ip:ais_server_port/ais_workspace;DefTdpName=ais_target_datasource_name;On
eTdpMode=1;qptdpname=BINDURL1;queryProcessor/noThreads=true;}}
接続文字列にパスワードを指定すると、タスクログファイルにプレーンテキストとして表示されます。そのため、GUIパスワードフィールドにパスワードを
指定することをお勧めします。

19
• 使用する ODBC エンドポイントの認証ユーザーの認証情報 (User Name, Password) を入力します。例えば、IBM DB2 プロバイダーを使用してい
る場合は、IBM DB2 システム管理者が使用します。この情報がわからない場合は、ODBC エンドポイントシステムアドミニストレータを参照してくださ
い。
手記：[ConnectionString] を選択する場合は、入力した接続文字列にUser NameとPasswordの情報を必ず入力してください。[Advanced ]
タブを使用してカスタム文字列を作成する場合は、必ず[User Name] プロパティと[Password] プロパティを含めます。詳細については、接続の詳細
プロパティの設定を参照してください。
• この情報は大文字と小文字を区別します。
• [Advanced ] タブでカスタムプロパティを設定できます。詳細については、接続の詳細プロパティの設定を参照してください。
手記：ODBC エンドポイントユーザーが、使用している ODBC プロバイダーに対して正しいアクセス権限を持っていることを確認します。

20
高度な接続プロパティの設定
[Advanced] タブでは、次のプロパティを設定できます。
• Provider syntax : プロバイダ構文の名前を選択します。HP ノンストップ SQL/MP ターゲットにレプリケートする場合は、プロバイダーの種類として
SQLMP (ARC) を選択する必要があります。
• Load usingCSV : CSV ファイルを使用してデータを読み込む場合に選択します。
• Max file size (KB) : ファイルをロードフォルダに移動する前に、CSV ファイルの最大サイズ (KB) を選択または入力します。デフォルト値は 32000 KB
です。

ODBCのソース・ターゲットエンドポイントとしての利用

Recommended

Recommended

More Related Content

What's hot

What's hot (20)

Similar to ODBCのソース・ターゲットエンドポイントとしての利用

Similar to ODBCのソース・ターゲットエンドポイントとしての利用 (20)

More from QlikPresalesJapan

More from QlikPresalesJapan (20)

ODBCのソース・ターゲットエンドポイントとしての利用