機械翻訳について

2 Sybaseゲートウェイの機能と制限事項

ゲートウェイをインストールして構成したら、ゲートウェイを使用してSybaseデータにアクセスしたり、SybaseコマンドをアプリケーションからSybaseデータベースに渡したり、分散問合せを実行したり、データをコピーしたりすることができます。

トピック:

• リモート挿入Rowsource

• パススルー機能の使用

• ストアド・プロシージャおよび関数の実行

• CHARセマンティクス

• マルチバイト文字セット比率抑制

• IPv6のサポート

• ゲートウェイ・セッションIDLEタイムアウト

• Sybaseのデータベース互換性の問題

• 既知の制限事項

• 既知の問題点

リモート挿入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パッケージを使用して、Sybaseコマンドまたは文をアプリケーションからSybaseデータベースに渡すことができます。

PL/SQLブロックでDBMS_HS_PASSTHROUGHパッケージを使用して、次のようにSybaseデータベースに渡す文を指定します:

DECLARE
    num_rows INTEGER;
BEGIN
    num_rows := DBMS_HS_PASSTHROUGH.EXECUTE_IMMEDIATE@SYBS('command');
END;
/

commandには、次のいずれも使用できません。

• BEGIN TRANSACTION

• COMMIT

• ROLLBACK

• SAVE

• SHUTDOWN

• Sybaseツール・コマンド

DBMS_HS_PASSTHROUGHパッケージでは、バインド値を渡すこと、およびSELECT文を実行することがサポートされています。

注意:

TRUNCATEはパススルー文では使用できません。

関連項目:

DBMS_HS_PASSTHROUGHパッケージの詳細については、「Oracle Database異機種間接続ユーザーズ・ガイド」の「Oracle Database PL/SQLパッケージと型リファレンス」および第3章、「Oracle Databaseゲートウェイの機能」を参照してください。

ストアド・プロシージャおよびストアド・ファンクションの実行

プロシージャ機能を使用すると、ゲートウェイはSybaseデータベースで定義されたストアド・プロシージャを実行できます。 ゲートウェイを再リンクするか、またはゲートウェイにプロシージャを定義する必要はありませんが、プロシージャのアクセス特権は、ゲートウェイによるアクセスを許可する必要があります。

ストアド・プロシージャの実行には、標準のPL/SQL文が使用されます。

ゲートウェイは、相互に排他的な3つのモードでストアド・プロシージャをサポートします:

• ノーマル・モード: IN/OUT引数のみにアクセスできます

• 戻り値モード: すべてのストアド・プロシージャの戻り値を持つ

• 結果セット・モード: アウト値は最後の結果セットとして使用可能です

戻り値とストアド・プロシージャ

デフォルトでは、すべてのストアド・プロシージャおよび関数は、ユーザーに戻り値を返しません。 戻り値を有効にするには、初期化パラメータ・ファイルでHS_FDS_PROC_IS_FUNCパラメータを設定します。

関連項目:

初期化パラメータ・ファイルとHS_FDS_PROC_IS_FUNCパラメータの編集に関する情報は、「初期化パラメータ」を参照してください。

注意:

HS_FDS_PROC_IS_FUNCゲートウェイ初期化パラメータを設定する場合は、既存のすべてのストアド・プロシージャのプロシージャexecute文の構文を変更する必要があります。

次の例では、従業員名JOHN SMYTHE がSybaseのストアド・プロシージャREVISE_SALARYに渡されます。 ストアド・プロシージャは、Sybaseデータベースから給与額を取得して、JOHN SMYTHEの新しい年俸を計算します。 RESULTで戻された改定給与は、Oracleデータベースの表のEMPを更新するために使用されます:

DECLARE
  INPUT VARCHAR2(15);
  RESULT NUMBER(8,2);
BEGIN
  INPUT := 'JOHN SMYTHE';
  RESULT := REVISE_SALARY@SYBS(INPUT);
  UPDATE EMP SET SAL = RESULT WHERE ENAME =: INPUT;
END;
/

プロシージャ機能により、Oracle以外のデータ型とPL/SQLデータ型との間の変換は自動的に行われます。

結果セットとストアド・プロシージャ

Oracle Database Gateway for Sybaseは、結果セットを返すストアド・プロシージャをサポートしています。

デフォルトでは、すべてのストアド・プロシージャおよび関数は、ユーザーに結果セットを返しません。 結果セットを使用可能にするには、初期化パラメータ・ファイルでHS_FDS_RESULTSET_SUPPORTパラメータを設定します。

関連項目:

初期化パラメータ・ファイルとHS_FDS_RESULTSET_SUPPORTパラメータの編集に関する情報は、「初期化パラメータ」を参照してください。 Oracle以外のデータベースの結果セットに対するOracleサポートの詳細は、「Oracle Database異機種間接続ユーザーズ・ガイド」を参照してください。

注意:

HS_FDS_RESULTSET_SUPPORTゲートウェイ初期化パラメータを設定する場合は、既存のすべてのストアド・プロシージャのプロシージャexecute文の構文を変更するか、エラーが発生する必要があります。

Oracle Database Gateway for Sybaseを使用して結果セットを含むストアド・プロシージャにアクセスすると、異機種間サービスの順次モードになります。

Oracle Database Gateway for Sybaseは、プロシージャの説明中に異機種間サービスに以下の情報を戻します:

• リモート・ストアド・プロシージャのすべての入力引数

• 出力引数はなし

• REF CURSOR型の1つの出力引数(ストアド・プロシージャにより返された最初の結果セットに対応)

クライアント・プログラムは、仮想パッケージ関数dbms_hs_result_set.get_next_result_setを使用して、後続の結果セットの参照カーソルを取得する必要があります。 返された最後の結果セットは、プロシージャの出力引数です。

結果セットへのアクセスには次の制限事項があります。

• リモート・ストアド・プロシージャにより返された結果セットは、送信された順序で取り出す必要があります。

• ストアド・プロシージャの実行時に、以前に実行されたストアド・プロシージャによって返されたすべての結果セットは、データが完全に終了したかどうかに関係なく閉じられます

次の例では、Sybaseストアド・プロシージャが実行され、Sybaseからempおよびdept表の内容をフェッチします:

create procedure REFCURPROC (@arg1 varchar(255), @arg2 varchar(255) output)
as
select @arg2 = @arg1
select * from EMP
select * from DEPT
go

このストアド・プロシージャは、入力パラメータarg1を出力パラメータarg2に割り当て、参照カーソルrc1で問合せSELECT * FROM EMPを開き、参照カーソルrc2で問合せSELECT * FROM DEPTを開きます。

注意:

ストアド・プロシージャを作成する前に、チェーン・モードを設定する必要があります。 Sybaseで次のコマンドを発行: 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@SYBS(:1,:2,:3); end;";
OraText *n_rs_stm = (OraText *)
  "begin :ret := DBMS_HS_RESULT_SET.GET_NEXT_RESULT_SET@SYBS; 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は、Sybaseのemp表とまったく同じローカル表であるとします。 同じ仮定がloc_deptに適用されます。outargsは、Sybaseのストアド・プロシージャの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@SYBS('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@SYBS;

  -- 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@SYBS;

  -- 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セマンティクス・モードで実行できます。 Sybase CHARカラムを常にCHAR(n BYTE)として記述するのではなく、CHAR(n CHAR)およびVARCHAR(n CHAR)として記述します。 この概念は、OracleデータベースのCHARセマンティクスに似ています。 このオプションをアクティブにするには、HS_NLS_LENGTH_SEMANTICS=CHARゲートウェイ・パラメータを指定する必要があります。 詳細は「初期化パラメータ」を参照してください。

マルチバイト文字セット比率抑制

この機能は、オプションで、マルチバイト文字セットを含むSybaseデータベースからOracleデータベースへの比率拡張を抑制します。 デフォルトでは、Oracleゲートウェイは、データが切り捨てられたり、バッファ・サイズが不十分な状態にならないように、最悪の比率を想定しています。 ただし、Sybaseデータベースに関する特定の知識があり、展開が発生しないようにするには、HS_KEEP_REMOTE_COLUMN_SIZEパラメータを指定して展開を抑制します。 詳細は「初期化パラメータ」を参照してください。

IPv6のサポート

Oracleデータベースとゲートウェイ間の完全なIPv6サポートに加えて、IPv6もこのゲートウェイとSybaseデータベース間でサポートされています。 詳細は、「初期化パラメータ」のHS_FDS_CONNECT_INFOパラメータを参照してください。

ゲートウェイ・セッションIDLEタイムアウト

必要に応じて、ゲートウェイ・パラメータHS_IDLE_TIMEOUTを使用して、長いアイドル・ゲートウェイ・セッションを自動的に終了することもできます。 具体的には、ゲートウェイ・セッションが指定された制限時間を超えてアイドル状態になると、保留中の更新がロールバックされてゲートウェイ・セッションが終了します。

Sybaseのデータベース互換性の問題

一部の領域でSybaseとOracleのデータベースの機能が異なるため、次のような互換性の問題が発生します:

• 連鎖モード

• 列の定義

• 命名規則

• データ型

• 問合せ

• ロック

• Sybase識別子の長さ制限

連鎖モード

ゲートウェイは、ANSI標準の連鎖モードをサポートしています。 このモードでは、Sybaseのストアド・プロシージャを記述する必要があります。 連鎖モードで実行すると、ゲートウェイはOracle 2フェーズ・コミット保護をOracleおよびSybaseデータベースを更新するトランザクションに拡張できます。

列の定義

デフォルトでは、NULLが列定義で指定されていないかぎり、Sybase表の列にはNULL値を含めることはできません。 ANSI規格に準拠して、Sybaseデータベース・オプション"allow nulls by default"をtrueに設定すると、デフォルトの列定義をNULLに変更できます。

Oracle表の場合、NOT NULLが列定義で指定されていないかぎり、NULL値が列に使用できます。

命名規則

ネーミング規則の問題は次のとおりです。

• オブジェクトのネーミング規則

• 大/小文字区別

オブジェクトのネーミング規則

OracleとSybaseは異なるデータベース・オブジェクト命名規則を使用します。 たとえば、各オブジェクト名に認められている最大文字数が違います。 また、一重引用符および二重引用符の使用、大/小文字の区別、英数字の使用もすべて異なります。

関連項目:

「Oracle Databaseリファレンス」とSybaseのマニュアルを参照してください。

大/小文字区別

識別子を二重引用符で囲まない限り、Oracleデータベースのデフォルトは大文字になります。 たとえば、empというSybase表を参照するには、次のように二重引用符で名前を入力します:

SQL> SELECT * FROM "emp"@SYBS;

ただし、OracleアプリケーションからSCOTTが所有するempというSybase表を参照するには、次のように入力します:

SQL> SELECT * FROM "Scott"."emp"@SYBS;

empというSybase表がSCOTT (大文字の表所有者名)に所有されている場合は、次のように二重引用符で囲まずに所有者名を入力できます:

SQL> SELECT * FROM SCOTT."emp"@SYBS;

または

SQL> SELECT * FROM scott."emp"@SYBS;

すべてのSybaseオブジェクト名を二重引用符で囲み、Sybaseデータ・ディクショナリに表示されるオブジェクト名には大文字の大文字小文字を使用することをお薦めします。 この規則は、サポートされているOracleデータ・ディクショナリ表または「データ辞書」にリストされているビューを参照する場合には必要ありません。

これらの規則に従って既存のアプリケーションを変更できない場合は、Oracleでビューを作成し、Sybase名を正しい大文字とするようにします。 たとえば、既存のOracleアプリケーションのSybase表empを大文字の名前のみで参照するには、次のビューを定義します:

SQL> CREATE VIEW EMP (EMPNO, ENAME, SAL, HIREDATE)
      AS SELECT "empno", "ename", "sal", "hiredate"
      FROM "emp"@SYBS;

このビューを使用して、アプリケーションは次のような文を発行できます。

SQL> SELECT EMPNO, ENAME FROM EMP;

ビューの使用は、Sybaseデータ・ディクショナリで生成されたデータ・ディクショナリ情報を複製する回避策です。 Sybaseデータベースで対応する表のデータ定義が変更されるたびに、Oracleビュー定義を更新する必要があります。

データ型

データ型の問題は次のとおりです。

• バイナリのリテラル表記

• データ型変換

バイナリのリテラル表記

Oracle SQLは、単一引用符で囲まれた16進数を使用して、データ型RAWとして定義された列に比較または挿入されるリテラル値を表します。

この表記法は、SybaseのVARBINARYおよびBINARYデータ型(0xの後に16進数を1つの引用符で囲む)と互換性のある構文に変換されません。

たとえば、次の文はサポートされていません。

SQL> INSERT INTO BINARY_TAB@SYBS VALUES ('0xff')

BINARY_TABには、データ型VARBINARYまたはBINARYの列が含まれています。 VARBINARYおよびBINARYデータ型を挿入または更新する場合は、バインド変数を使用します。

データ型変換

Sybaseでは暗黙的な日付変換をサポートしていません。 このような変換は明示的にする必要があります。

たとえば、ゲートウェイは次のSELECT文にエラーを発行します:

SELECT DATE_COL FROM TEST@SYBS WHERE DATE_COL = "1-JAN-2001";

暗黙的変換の問題を回避するには、次のように明示的変換を追加します。

SELECT DATE_COL FROM TEST@SYBS WHERE DATE_COL = TO_DATE("1-JAN-2001")

関連項目:

データ型に関する制限事項の詳細は、「データ型変換」を参照してください。

問合せ

問合せの問題は次のとおりです。

• 行選択

• 空の文字列

• 空のバインド変数

行の選択

Sybaseは、選択したすべての行の問合せ条件を評価してから、いずれかの行を戻します。 1行以上について評価処理でエラーが発生すると、残りの行が条件を満たしていても行は一切返されません。

Oracleでは、1行ずつ問合せ条件を評価し、評価処理でエラーが発生しなければ行を返します。 行の評価処理でエラーが発生するまで、行は返されます。

空の文字列

Oracleでは、SQL文の空の文字列をNULL値として処理します。 Sybaseは空の文字列を空の文字列として処理します。

空の文字列を比較すると、ゲートウェイは文字通り空の文字列を変換せずにSybaseデータベースに渡します。 空の文字列がNULL値を表すことを意図していた場合、Sybaseはそのように文を処理しません。それは空の文字列を使用します。

次の例のように、空の文字列構文ではなく、SQL文でNULLまたは IS NULLを使用することで、この問題を回避できます:

SELECT * from "emp"@SYBS where "ename" IS NULL;

空の文字列の選択

VARCHAR列の場合、ゲートウェイは空の文字列をOracleデータベースにNULLの値として返します。

CHAR列の場合、ゲートウェイは各文字を空白( '')として列のフル・サイズを戻します。

空のバインド変数

VARCHARバインド変数の場合、ゲートウェイは空のバインド変数をNULL値としてSybaseデータベースに渡します。

ロック

Sybaseデータベースのロック・モデルは、Oracleモデルと大きく異なります。 ゲートウェイは基本的なSybaseの動作に依存するため、ゲートウェイを介してSybaseにアクセスするOracleアプリケーションは、次のような可能性があります:

• 読取りアクセスで書込みアクセスをブロックする場合

• 書込みアクセスで読取りアクセスをブロックする場合

• 文レベルの読取り一貫性が保証されない場合

  関連項目:

  Sybaseのロック・モデルについては、Sybaseのマニュアルを参照してください。

Sybase識別子の長さ制限

デフォルトでは、ゲートウェイは常に識別子を引用します。 ただし、特定のSybaseリリースでは、表名や列名などの識別子に30文字の制限があり、この制限をチェックするときには引用符は名前の一部とみなされます。 したがって、引用符を使用する場合は、28文字しか指定できません。 これらのSybaseリリースの最大長制限をサポートするには、ゲートウェイ初期化パラメータ・ファイルでHS_FDS_QUOTE_IDENTIFIER=FALSEを指定する必要があります。 この初期化パラメータを設定すると、ゲートウェイは識別子を引用符なしで送信します。 ただし、ドット(。)またはスペースを含む識別子の使用を排除するという副作用があり、識別子は使用されるSybaseデータベースの大文字小文字の区別に従います。

既知の制限事項

この項または既知の問題点で示されていない非互換性の問題が発生した場合は、Oracleサポート・サービスに連絡してください。 この項では、次の既知の制限事項について説明し、可能な場合はそれらに対処するための提案を示します。

• トランザクションの整合性

• トランザクション機能

• PL/SQLカーソル・ループのCOMMITまたはROLLBACKによるオープン・カーソルのクローズ

• ストアド・プロシージャ

• パススルー機能

• Sybase NCHARおよびNVARCHARデータ型

• SQL構文

• 小文字の表名を使用するSQL*PlusのCOPYコマンド

• データベース・リンク

次の制限も適用されます:

• SUBSTR関数の第2パラメータとして負の数を使用すると、不正な結果が返されます。 これは、OracleのSUBSTR関数とSybaseの同等の関数との間に互換性がないためです。

  注意:

  制限事項については、Oracleサポート・サービスに問い合せてください。

トランザクションの整合性

次のような場合、ゲートウェイではトランザクションの整合性が保証されません。

• ゲートウェイで処理される文により、ターゲット・データベースで暗黙的コミットが発生する場合

• ターゲット・データベースが自動コミット・モードで動作するように構成されている場合

  注意:

  次のことをお薦めします。

  • 特定の文を実行するとターゲット・データベースで暗黙的コミットが発生することがわかっている場合は、その文が独自のトランザクションで実行されるようにします。

  • 自動コミット・モードで動作するようにターゲット・データベースを構成しないでください。

トランザクション機能

ゲートウェイでは、セーブポイントはサポートされていません。 ゲートウェイを含む分散更新トランザクションが進行中で、ユーザーが保存ポイントを作成しようとすると、次のエラーが発生します:

ORA-02070: database dblink does not support savepoint in this context

デフォルトでは、ゲートウェイはCOMMIT_CONFIRMとして構成され、トランザクションによってSybaseデータベースが更新されると、常にコミット・ポイント・サイトになります。

PL/SQLカーソル・ループのCOMMITまたはROLLBACKによるオープン・カーソルのクローズ

PL/SQLカーソル・ループで発行されたCOMMITまたはROLLBACKは、開いているすべてのカーソルを閉じます。これにより、次のエラーが発生する可能性があります:

ORA-1002:  fetch out of sequence 

このエラーを回避するには、COMMITまたはROLLBACK文をカーソル・ループの外に移動します。

ストアド・プロシージャ

コミットまたはロールバックを組み込んだストアド・プロシージャによって発行された変更は、Oracleトランザクション・マネージャまたはOracle COMMITまたはROLLBACKコマンドで制御することはできません。

Oracle Database Gateway for Sybaseを使用して結果セットを含むストアド・プロシージャにアクセスする場合は、異機種間サービスの順次モードで作業する必要があります。

Oracle Database Gateway for Sybaseを使用して複数の結果セットを持つストアド・プロシージャにアクセスする場合は、続行する前にすべての結果セットを読み込む必要があります。

ストアド・プロシージャの出力パラメータは、NULL値に初期化する必要があります。

Oracle Database Gateway for Sybaseは、パススルー問合せ内で出力パラメータまたは出力パラメータを含むストアド・プロシージャをサポートしていません。

パススルー機能

ゲートウェイパス・スルー機能を使用してSybaseによって実行されるDDL文は、複数文トランザクションの場合に失敗する可能性があります。 トランザクションでDDL文を使用できるようにするには、Sybaseオプション"ddl in tran"を設定します。

パススルー機能を使用して文を実行する場合は、DDL文を独自のトランザクションに配置することをお薦めします。 明示的なCOMMITは、DDL文の後に発行する必要があります。

ゲートウェイを通過するSQL文がSybaseデータベースで暗黙的なコミットになった場合、Oracleトランザクション・マネージャはコミットを認識せず、Oracle ROLLBACKコマンドを使用してトランザクションをロールバックすることはできません。

Sybase NCHARおよびNVARCHARデータ型

ゲートウェイは、Sybase NCHARまたはNVARCHARデータ型で定義された列を選択できません。

SQL構文

SQL構文の制限事項は次のとおりです:

• WHERE CURRENT OF句

• CONNECT BY句

• ROWID

• INSERT文の副問合せ

• EXPLAIN PLAN文

関連項目:

SQL構文に関する制限事項の詳細は、サポート対象のSQL構文および関数を参照してください。

WHERE CURRENT OF句

WHERE CURRENT OF句を含むUPDATEおよびDELETE文は、Oracle ROWIDの実装に依存しているため、ゲートウェイではサポートされていません。 ゲートウェイを通じて特定の行を更新または削除するには、条件スタイルとしてWHERE句を使用する必要があります。

CONNECT BY句

ゲートウェイでは、SELECT文でのCONNECT BY句はサポートされていません。

ROWID

Oracle ROWIDの実装はサポートされていません。

INSERT文の副問合せ

INSERT文の副問合せでは、同じ表に対して複数の別名を使用できません。 たとえば、次の文はサポートされていません。

SQL> INSERT INTO "emp_target"@SYBS
         SELECT a."empno" FROM "emp_source"@SYBS a,
            "emp_source"@SYBS b WHERE b."empno"=9999

EXPLAIN PLAN文

EXPLAIN PLAN 文はサポートされていません。

小文字の表名を使用するSQL*PlusのCOPYコマンド

小文字の表名を二重引用符で囲む必要があります。

次に例を示します。

copy from tkhouser/tkhouser@inst1 insert loc_tkhodept using select * from "tkhodept"@holink2;

データベース・リンク

ゲートウェイはマルチスレッド化されていないため、共有データベース・リンクをサポートできません。 ゲートウェイ・セッションはそれぞれ別のゲートウェイ・プロセスを起動し、接続は共有されません。

既知の問題点

この項では、既知の問題点について説明し、可能な場合は問題を修正するための提案を示します。 問題についての疑問は、Oracleサポート・サービスに問い合せてください。 問題の最新リストはオンラインで入手可能です。 リストへのアクセス方法については、地域のOracleのオフィスに問い合せてください。

既知の問題は次のとおりです:

• 暗号化形式のログイン

• 日付計算

• Sybase IMAGEおよびTEXTデータ型

• 文字列関数

• スキーマ名とPL/SQL

• データ・ディクショナリ・ビューとPL/SQL

• ストアド・プロシージャ

暗号化形式のログイン

Oracleデータベースでは、初期化パラメータDBLINK_ENCRYPT_LOGINはサポートされなくなりました。 バージョン7.3までは、このパラメータのデフォルトのTRUE値は、ログイン・ユーザーIDのパスワードがネットワーク上に(クリア・テキストで)送信されることを防ぎました。 それより後のバージョンでは、パスワードが自動的に暗号化されます。

日付計算

次のSQL式は、ゲートウェイでは正しく機能しません。

date + numbernumber + datedate - numberdate1 - date2

前述の式を含む文は、翻訳されずにSybaseデータベースに送信されます。 Sybaseはこれらの日付演算関数をサポートしていないため、文はエラーを返します。

Sybase IMAGEおよびTEXTデータ型

IMAGEおよびTEXTデータ型を使用する場合、次の制限が適用されます:

• サポートされないSQL関数は、Sybaseデータ型IMAGEまたはTEXTとして定義された列にアクセスするSQL文では使用できません。

• データが80文字を超える場合、SQL*Plusを使用して、Sybaseデータ型IMAGEまたはTEXTとして定義された列からデータを選択することはできません。 Pro * CまたはOracle Call Interfaceを使用して、Sybaseデータベース内のそのようなデータにアクセスすることをお薦めします。

• IMAGEおよびTEXTデータは、パススルー問合せで読み取ることはできません。

ゲートウェイは、DBMS_SQLパッケージのPL/SQL関数COLUMN_VALUE_LONGをサポートしていません。

関連項目:

SQL構文に関する制限事項の詳細は、サポート対象のSQL構文および関数を参照してください。

文字列関数

ゲートウェイを使用してSybaseデータベースを問合せするときに"||" 演算子を使用して数値リテラルを連結すると、結果は算術加算になります。 たとえば、次の文の結果は18です。

SQL> SELECT 9 || 9 FROM DUAL@SYBS;

Oracleを使用してOracleデータベースを問合せすると、結果は99になります。

スキーマ名とPL/SQL

PL/SQLブロック内のSQL文にSybaseデータベース・オブジェクトのスキーマ名をプレフィクスとして指定しないと、次のエラー・メッセージが表示されます:

ORA-6550 PLS-201 Identifier table_name must be declared.

SQL文を変更して、オブジェクトのスキーマ名を含めます。

データ・ディクショナリ・ビューとPL/SQL

PL/SQLブロック内にあるSQL文では、データ・ディクショナリ・ビューは参照できません。

ストアド・プロシージャ

結果セットを返すストアド・プロシージャの戻り値が正しくありません。