2 Teradata Gatewayの機能と制限事項
ゲートウェイをインストールして構成したら、ゲートウェイを使用してTeradataデータにアクセスしたり、アプリケーションからTeradataデータベースにTeradataコマンドを渡したり、分散問合せを実行したり、データをコピーしたりすることができます。
トピック:
リモート挿入Rowsource
リモート挿入行ソース機能を使用すると、ローカルOracleデータをOracleデータベースおよびOracle Databaseゲートウェイで処理する必要があるリモート挿入が可能になります。 この機能を使用するには、OracleデータベースとOracle Databaseゲートウェイをバージョン12.2以降にする必要があります。
Oracle Databaseデザインでは、データベース・リンク・サイトで分散文を実行する必要があります。 しかし、特定の状況では、これらの問合せを実行するために必要なデータがあります。このデータは、元のOracle Databaseからフェッチする必要があります。 同種の接続では、リモートOracleデータベースは、そのようなデータのソースOracleデータベースをコールバックします。 しかし、異種の接続では、これは実行可能ではありません。これは、外部データストアが、問合せを発行したOracleインスタンスによってのみ提供できるコールバック関数またはデータを問合せする必要があることを意味するためです。 一般的に、これらの種類の文は、Oracle Databaseゲートウェイでサポートできるものではありません。
次のカテゴリのSQL文では、コールバックが発生します:
-
Oracleデータベース内の表を参照するサブ選択付きDML。
-
DELETE、INSERT、UPDATEまたは"SELECT... FOR UPDATE..."元のOracleデータベースで実行する必要があるSQL関数または文を含むSQL文。これらのSQL関数には、
USER、USERENV、およびSYSDATEが含まれます。元のOracleデータベースからのデータの選択を伴います。 -
Oracleデータベース内の表を含むSQL文、およびリモート表の
LONGまたはLOB列。
リモート挿入rowsource機能を使用して動作するリモートINSERTの例を次に示します:
INSERT INTO gateway_table@gateway_link select * from local_table;
パススルー機能の使用
ゲートウェイは、DBMS_HS_PASSTHROUGHパッケージを使用して、アプリケーションからのTeradataコマンドまたは文をTeradataデータベースに直接渡すことができます。
PL/SQLブロックのDBMS_HS_PASSTHROUGHパッケージを使用して、次のようにTeradataデータベースに渡す文を指定します:
DECLARE
num_rows INTEGER;
BEGIN
num_rows := DBMS_HS_PASSTHROUGH.EXECUTE_IMMEDIATE@TERA('command');
END;
/
ここで、commandは次のいずれかになりません:
-
BEGIN TRANSACTION -
BT -
COMMIT -
END TRANSACTION -
ET -
ROLLBACK
DBMS_HS_PASSTHROUGHパッケージでは、バインド値を渡すこと、およびSELECT文を実行することがサポートされています。
関連項目:
DBMS_HS_PASSTHROUGHパッケージの詳細については、「Oracle Database異機種間接続ユーザーズ・ガイド」の「Oracle Database PL/SQLパッケージと型リファレンス」および第3章、「Oracle Databaseゲートウェイの機能」を参照してください。
ストアド・プロシージャおよびストアド・ファンクションの実行
プロシージャ機能を使用すると、ゲートウェイはTeradataデータベースで定義されているストアド・プロシージャを実行できます。 ゲートウェイを再リンクするか、またはゲートウェイにプロシージャを定義する必要はありませんが、プロシージャのアクセス特権は、ゲートウェイによるアクセスを許可する必要があります。
Standard PL/SQL文は、ストアド・プロシージャの実行に使用されます。
ゲートウェイは、相互に排他的な3つのモードでストアド・プロシージャをサポートします:
-
ノーマル・モード:
IN/OUT引数のみにアクセスできます -
戻り値モード: すべてのストアド・プロシージャの戻り値を持つ
-
結果セット・モード: アウト値は最後の結果セットとして使用可能です
戻り値とストアド・プロシージャ
デフォルトでは、すべてのストアド・プロシージャおよび関数は、ユーザーに戻り値を返しません。 戻り値を有効にするには、初期化パラメータ・ファイルでHS_FDS_PROC_IS_FUNCパラメータを設定します。
関連項目:
初期化パラメータ・ファイルとHS_FDS_PROC_IS_FUNCパラメータの編集に関する情報は、「初期化パラメータ」を参照してください。
注意:
HS_FDS_PROC_IS_FUNCゲートウェイ初期化パラメータを設定する場合は、既存のすべてのストアド・プロシージャのプロシージャexecute文の構文を変更する必要があります。
次の例では、従業員名JOHN SMYTHE がTeradataストアド・プロシージャREVISE_SALARYに渡されます。 ストアド・プロシージャは、Teradataデータベースから給与額を取得して、JOHN SMYTHEの新しい年俸を計算します。 RESULTで戻された改定給与は、Oracleデータベースの表のEMPを更新するために使用されます:
DECLARE INPUT VARCHAR2(15); RESULT NUMBER(8,2); BEGIN INPUT := 'JOHN SMYTHE'; RESULT := REVISE_SALARY@TERA(INPUT); UPDATE EMP SET SAL = RESULT WHERE ENAME =: INPUT; END; /
この手順では、Oracle以外のデータ型をPL/SQLデータ型に自動的に変換します。
結果セットとストアド・プロシージャ
Oracle Database Gateway for Teradataは、結果セットを返すストアド・プロシージャをサポートしています。
デフォルトでは、すべてのストアド・プロシージャおよびファンクションからユーザーに結果セットが戻されることはありません。 結果セットを使用可能にするには、初期化パラメータ・ファイルでHS_FDS_RESULTSET_SUPPORTパラメータを設定します。
関連項目:
初期化パラメータ・ファイルとHS_FDS_RESULTSET_SUPPORTパラメータの編集に関する情報は、「初期化パラメータ」を参照してください。 Oracle以外のデータベースの結果セットに対するOracleサポートの詳細は、「Oracle Database異機種間接続ユーザーズ・ガイド」を参照してください。
注意:
HS_FDS_RESULTSET_SUPPORTゲートウェイ初期化パラメータを設定する場合は、既存のすべてのストアド・プロシージャのプロシージャexecute文の構文を変更するか、エラーが発生する必要があります。
Oracle Database Gateway for Teradataを使用して結果セットを含むストアド・プロシージャにアクセスすると、異機種間サービスの順次モードになります。
Oracle Database Gateway for Teradataは、プロシージャの説明中に異機種間サービスに以下の情報を戻します:
-
リモート・ストアド・プロシージャのすべての入力引数
-
出力引数はなし
-
タイプがref cursorの1つの引数(ストアド・プロシージャから返される最初の結果セットに対応)
クライアント・プログラムは、仮想パッケージ関数dbms_hs_result_set.get_next_result_setを使用して、後続の結果セットの参照カーソルを取得する必要があります。 最後に返された結果セットは、プロシージャからの出力引数です。
結果セットへのアクセスの制限は次のとおりです:
-
リモート・ストアド・プロシージャによって返される結果セットは、ワイヤー上に置かれた順序で取得する必要があります
-
ストアド・プロシージャの実行時に、以前に実行されたストアド・プロシージャによって返されたすべての結果セットは、データが完全に終了したかどうかに関係なく閉じられます
次の例では、Teradataからempおよびdept表の内容をフェッチするために、Teradataストアド・プロシージャが実行されます:
CREATE PROCEDURE refcurproc (@arg1 varchar(255), @arg2 varchar(255) output) AS SECLECT @arg2 = @arg1 SELECT * FROM EMP SELECT * FROM DEPT GO
このストアド・プロシージャは、入力パラメータarg1を出力パラメータarg2に割り当て、参照カーソルrc1で問合せSELECT * FROM EMPを開き、参照カーソルrc2で問合せSELECT * FROM DEPTを開きます。
注意:
ストアド・プロシージャを作成する前に、チェーン・モードを設定する必要があります。 Teradataで次のコマンドを実行: set chained on
結果セットからのOCIプログラムの順次モードによるフェッチ
次の例は、結果セットから順次モードでフェッチするOCIプログラムを示しています:
OCIEnv *ENVH;
OCISvcCtx *SVCH;
OCIStmt *STMH;
OCIError *ERRH;
OCIBind *BNDH[3];
OraText arg1[20];
OraText arg2[255];
OCIResult *rset;
OCIStmt *rstmt;
ub2 rcode[3];
ub2 rlens[3];
sb2 inds[3];
OraText *stmt = (OraText *) "begin refcurproc@TERA(:1,:2,:3); end;";
OraText *n_rs_stm = (OraText *)
"begin :ret := DBMS_HS_RESULT_SET.GET_NEXT_RESULT_SET@TERA; end;";
/* Prepare procedure call statement */
/* Handle Initialization code skipped */
OCIStmtPrepare(STMH, ERRH, stmt, strlen(stmt), OCI_NTV_SYNTAX, OCI_DEFAULT);
/* Bind procedure arguments */
inds[0] = 0;
strcpy((char *) arg1, "Hello World");
rlens[0] = strlen(arg1);
OCIBindByPos(STMH, &BNDH[0], ERRH, 1, (dvoid *) arg1, 20, SQLT_CHR,
(dvoid *) &(inds[0]), &(rlens[0]), &(rcode[0]), 0, (ub4 *) 0,
OCI_DEFAULT);
inds[1] = -1;
OCIBindByPos(STMH, &BNDH[1], ERRH, 1, (dvoid *) arg2, 20, SQLT_CHR,
(dvoid *) &(inds[1]), &(rlens[1]), &(rcode[1]), 0, (ub4 *) 0,
OCI_DEFAULT);
inds[2] = 0;
rlens[2] = 0;
OCIDescriptorAlloc(ENVH, (dvoid **) &rset, OCI_DTYPE_RSET, 0, (dvoid **) 0);
OCIBindByPos(STMH, &BNDH[2], ERRH, 2, (dvoid *) rset, 0, SQLT_RSET,
(dvoid *) &(inds[2]), &(rlens[2]), &(rcode[2]),
0, (ub4 *) 0, OCI_DEFAULT);
/* Execute procedure */
OCIStmtExecute(SVCH, STMH, ERRH, 1, 0, (CONST OCISnapshot *) 0,
(OCISnapshot *) 0, OCI_DEFAULT);
/* Convert result set to statement handle */
OCIResultSetToStmt(rset, ERRH);
rstmt = (OCIStmt *) rset;
/* After this the user can fetch from rstmt */
/* Issue get_next_result_set call to get handle to next_result set */
/* Prepare Get next result set procedure call */
OCIStmtPrepare(STMH, ERRH, n_rs_stm, strlen(n_rs_stm), OCI_NTV_SYNTAX,
OCI_DEFAULT);
/* Bind return value */
OCIBindByPos(STMH, &BNDH[1], ERRH, 1, (dvoid *) rset, 0, SQLT_RSET,
(dvoid *) &(inds[1]), &(rlens[1]), &(rcode[1]),
0, (ub4 *) 0, OCI_DEFAULT);
/* Execute statement to get next result set*/
OCIStmtExecute(SVCH, STMH, ERRH, 1, 0, (CONST OCISnapshot *) 0,
(OCISnapshot *) 0, OCI_DEFAULT);
/* Convert next result set to statement handle */
OCIResultSetToStmt(rset, ERRH);
rstmt = (OCIStmt *) rset;
/* Now rstmt will point to the second result set returned by the
remote stored procedure */
/* Repeat execution of get_next_result_set to get the output arguments */
順次モードでの結果セットからのPL/SQLプログラムのフェッチ
表loc_empは、Teradata emp表とまったく同じローカル表であるとします。 同じ仮定がloc_deptに適用されます。outargsは、Teradataストアド・プロシージャのout引数に対応する列を持つ表です。
create or replace package rcpackage is type RCTYPE is ref cursor; end rcpackage; /
declare
rc1 rcpackage.rctype;
rec1 loc_emp%rowtype;
rc2 rcpackage.rctype;
rec2 loc_dept%rowtype;
rc3 rcpackage.rctype;
rec3 outargs%rowtype;
out_arg varchar2(255);
begin
-- Execute procedure
out_arg := null; refcurproc@TERA('Hello World', out_arg, rc1);
-- Fetch 20 rows from the remote emp table and insert them into loc_emp
for i in 1 .. 20 loop
fetch rc1 into rec1;
insert into loc_emp (rec1.empno, rec1.ename, rec1.job,
rec1.mgr, rec1.hiredate, rec1.sal, rec1.comm, rec1.deptno);
end loop;
-- Close ref cursor
close rc1;
-- Get the next result set returned by the stored procedure
rc2 := dbms_hs_result_set.get_next_result_set@TERA;
-- Fetch 5 rows from the remote dept table and insert them into loc_dept
for i in 1 .. 5 loop
fetch rc2 into rec2;
insert into loc_dept values (rec2.deptno, rec2.dname, rec2.loc);
end loop;
--Close ref cursor
close rc2;
-- Get the output arguments from the remote stored procedure
-- Since we are in sequential mode, they will be returned in the
-- form of a result set
rc3 := dbms_hs_result_set.get_next_result_set@TERA;
-- Fetch them and insert them into the outarguments table
fetch rc3 into rec3;
insert into outargs (rec3.outarg, rec3.retval);
-- Close ref cursor
close rc3;
end;
/CHARセマンティクス
この機能により、ゲートウェイはオプションでCHARセマンティクス・モードで実行できます。 TeradataのCHAR列を常にCHAR(n BYTE)として記述するのではなく、CHAR(n CHAR)およびVARCHAR(n CHAR)として記述します。 この概念は、OracleデータベースのCHARセマンティクスに似ています。 このオプションをアクティブにするには、HS_NLS_LENGTH_SEMANTICS=CHARを指定する必要があります。 詳細は「初期化パラメータ」を参照してください。
マルチバイト文字セット比率抑制
この機能は、TeradataデータベースからOracleデータベースへのマルチバイト文字セット(たとえば、US7ASCIIからAL32UTF8、またはKO16MSWIN949からKO16KSC5601)を含む比率の拡張をオプションで抑制します。 デフォルトでは、データが切り捨てられないように、またはサイズが不十分なバッファが割り当てられないように、Oracleゲートウェイは最悪の比率を想定しています。 ただし、Teradataデータベースに関する特定の知識があり、展開が発生しないようにするには、HS_KEEP_REMOTE_COLUMN_SIZEパラメータを指定して展開を抑制します。 詳細は「初期化パラメータ」を参照してください。
IPv6のサポート
Oracleデータベースとゲートウェイ間の完全なIPv6サポートに加えて、IPv6もこのゲートウェイとTeradataの間でサポートされています。 詳細については、「初期化パラメータ」のHS_FDS_CONNECT_INFOパラメータを参照してください。
ゲートウェイ・セッションIDLEタイムアウト
必要に応じて、ゲートウェイ・パラメータHS_IDLE_TIMEOUTを使用して、長いアイドル・ゲートウェイ・セッションを自動的に終了することもできます。 具体的には、ゲートウェイ・セッションが指定された制限時間を超えてアイドル状態になると、保留中の変更がロールバックされてゲートウェイ・セッションが終了します。
Teradataのデータベース互換性の問題
一部の地域でTeradataとOracleデータベースの機能が異なるため、互換性の問題が発生します。 互換性の問題については、次のリンクで説明しています:
スキーマに関する考慮事項
Oracleのスキーマ概念はTeradataには存在しません。 問合せに含まれるスキーマ名は、Teradataによってデータベース名として認識されます。 Oracleデータベースでは、オブジェクトのスキーマはそのオブジェクトの所有者と同じです。 しかし、ALL_TABLESなどのデータ・ディクショナリ・ビューでOWNERフィールドを取得または参照する場合、OWNERフィールドは実際にTeradataデータベース名を参照しています。
データ・ディクショナリ表を問合せすると、次の結果が返されます:
-
ALL_*データ・ディクショナリ表では、すべてのTeradataデータベースのデータが返されます。 Teradataデータベース名は、参照されるデータ・ディクショナリ表に応じて、OWNER、INDEX_OWNER、またはTABLE_OWNER列に戻されます。 -
ALL_USERSデータ・ディクショナリ表では、各Teradataデータベース名はUSERNAME列に戻されます。 -
USER_*データ・ディクショナリ表では、参照されるデータ・ディクショナリ表に応じて、OWNERまたはTABLE_OWNER列に対してデフォルトのTeradataデータベースのデータが戻されます。 デフォルトのTeradataデータベースが定義されていない場合、DBC Teradataシステム・データベースが使用されます。
命名規則
ネーミング・ルールの問題には、次のものがあります:
オブジェクトのネーミング規則
OracleとTeradataは異なるデータベース・オブジェクト命名規則を使用します。 たとえば、各オブジェクト名に許可される最大文字数は異なっていてもかまいません。 また、一重引用符と二重引用符、大/小文字の区別、および英数字の使用はすべて異なっていてもかまいません。
大文字と小文字の区別
識別子を二重引用符で囲まない限り、Oracleデータベースのデフォルトは大文字になります。 たとえば、empというTeradata表を参照するには、次のように二重引用符で名前を入力します:
SQL> SELECT * FROM "emp"@TERA;
ただし、OracleアプリケーションからScottというTeradataデータベースのempというTeradata表を参照するには、次のように入力します:
SQL> SELECT * FROM "Scott"."emp"@TERA;
TeradataデータベースのSCOTTという名前のTeradataデータベースでempという名前のTeradata表が大文字で構成されている場合は、次のように二重引用符を使用しないで所有者名を入力できます:
SQL> SELECT * FROM SCOTT."emp"@TERA;
または
SQL> SELECT * FROM scott."emp"@TERA;
すべてのTeradataオブジェクト名を二重引用符で囲み、Teradataデータ・ディクショナリに表示されるオブジェクト名には大文字小文字を使用することをお薦めします。 この規則は、サポートされているOracleデータ・ディクショナリ表または「データ辞書」にリストされているビューを参照する場合には必要ありません。
これらの規則に従って既存のアプリケーションを変更できない場合は、OracleでTeradata名を正しい文字の大文字小文字に関連付けるビューを作成します。 たとえば、大文字の名前のみを使用して既存のOracleアプリケーションのTeradata表empを参照するには、次のビューを定義します:
SQL> CREATE VIEW EMP (EMPNO, ENAME, SAL, HIREDATE)
AS SELECT "empno", "ename", "sal", "hiredate"
FROM "emp"@TERA;
このビューでは、アプリケーションは次のような文を発行できます:
SQL> SELECT EMPNO, ENAME FROM EMP;
ビューの使用は、Teradataデータ辞書に由来するデータ辞書情報を複製する回避策です。 Teradataデータベースで対応する表のデータ定義が変更されるたびに、Oracleビュー定義を更新する必要があります。
データ型
データ型の問題には、次のものがあります:
バイナリ・リテラル表記
Oracle SQLは、単一引用符で囲まれた16進数を使用して、データ型RAWとして定義された列に比較または挿入されるリテラル値を表します。
この表記法は、TeradataのVARBINARYおよびBINARYデータ型(単一引用符で囲まれたffの後に16進数が続く)と互換性のある構文に変換されません。
たとえば、次の文はサポートされていません。
SQL> INSERT INTO BINARY_TAB@TERA VALUES ('ff'xb)
ここで、BINARY_TABには、データ型VARBINARYまたはBINARYの列が含まれています。 VARBINARYおよびBINARYデータ型を挿入または更新する場合は、バインド変数を使用します。
データ型変換
Teradataは暗黙の日付変換をサポートしていません。 そのような変換は明示的である必要があります。
たとえば、ゲートウェイは次のSELECT文にエラーを発行します:
SELECT DATE_COL FROM TEST@TERA WHERE DATE_COL = "1-JAN-2001";
暗黙的な変換に関する問題を回避するには、次のように明示的な変換を追加します:
SELECT DATE_COL FROM TEST@TERA WHERE DATE_COL = TO_DATE("1-JAN-2001")
関連項目:
データ型に関する制限事項の詳細は、「データ型変換」を参照してください。
問合せ
行選択
Teradataは、選択したすべての行の問合せ条件を評価してから、いずれかの行を返します。 評価プロセスで1行以上の行に対してエラーが発生した場合、残りの行が条件を満たしていても行は返されません。
Oracleでは、問合せ条件行が評価され、評価が成功した場合は行が返されます。 行の評価が失敗するまで、行が戻されます。
既知の制限事項
この項または既知の問題点で示されていない非互換性の問題が発生した場合は、Oracleサポート・サービスに連絡してください。 次のトピックでは、既知の制限事項について説明し、可能な場合はそれらの制限事項を処理するための推奨事項を示します:
トランザクション整合性
次の場合、ゲートウェイはトランザクションの整合性を保証できません:
-
ゲートウェイによって処理される文によって、ターゲット・データベースで暗黙的にコミットされる場合
-
ターゲット・データベースが自動コミット・モードで動作するように構成されている場合
注意:
Oracleは、次のことを強く推奨します:
-
特定の文を実行するとターゲット・データベースで暗黙的にコミットされることがわかっている場合は、その文が独自のトランザクションで実行されるようにしてください。
-
自動コミット・モードで動作するようにターゲット・データベースを構成しないでください。
-
PL/SQLカーソル・ループのCOMMITまたはROLLBACKによるオープン・カーソルのクローズ
PL/SQLカーソル・ループで発行されたCOMMITまたはROLLBACKは、開いているすべてのカーソルを閉じます。これにより、次のエラーが発生する可能性があります:
ORA-1002: fetch out of sequence
このエラーを回避するには、COMMITまたはROLLBACK文をカーソル・ループの外に移動します。
日付列のバインド変数
データ型TIMEまたはTIMESTAMPの列をバインド変数と比較することはできません。
次のSQL文によってエラー・メッセージが表示されます:
SQL> select time_column from time_table@TERA where time_column = :a;
次のエラーが発行されます:
Invalid operation on an ANSI Datetime or Interval value.
SQL*Plus
小文字の表名を二重引用符で囲む必要があります。
次に例を示します。
copy from tkhouser/tkhouser@inst1 insert loc_tkhodept using select * from "tkhodept"@TERA;
既知の問題点
この項では、既知の問題点について説明し、可能な場合は問題を修正するための提案を示します。 問題についての疑問は、Oracleサポート・サービスに問い合せてください。 現在の問題のリストは、オンライン上で入手できます。 リストへのアクセスの詳細は、ローカルのOracleオフィスに問い合せてください。
既知の問題は次のとおりです:
Teradata LONG VARCHARデータ型
LONG VARCHARデータ型を使用する場合、次の制限が適用されます:
-
サポートされていないSQL関数は、Teradataデータ型
LONG VARCHARとして定義された列にアクセスするSQL文では使用できません。 -
データが80文字を超える場合、SQL*Plusを使用してTeradataデータ型
LONG VARCHARとして定義された列からデータを選択することはできません。 Pro * CまたはOracle Call Interfaceを使用して、Teradataデータベース内のそのようなデータにアクセスすることをお薦めします。 -
LONG VARCHARデータ型は、INSERTまたはUPDATEが動作するためにはNULLABLEでなければなりません。 -
LONG VARCHAR列を含む表には、表に固有の索引が定義されている必要があります。または、表には主キーとして機能する別個の列が必要です。 -
LONG VARCHARデータをパススルー問合せで読み取ることはできません。
ゲートウェイは、DBMS_SQLパッケージのPL/SQL関数COLUMN_VALUE_LONGをサポートしていません。
関連項目:
SQL構文に関する制限事項の詳細は、サポート対象のSQL構文および関数を参照してください。
スキーマ名とPL/SQL
PL/SQLブロック内のSQL文でTeradataデータベース・オブジェクトのスキーマ名をプレフィクスとして指定しないと、次のエラー・メッセージが表示されます:
ORA-6550 PLS-201 Identifier table_name must be declared.
オブジェクトのスキーマ名を含めるようにSQL文を変更します。