拡張レベル関数 - ODBC Driver for Teradata

SQLBindParameterは、パラメータ長(pcbValue)がSQL_NULL_DATAに等しい場合、パラメータ データ(rgbValue)のNULLポインタを受け入れます。SQLBindParameterがサポートするパラメータの最大数は256です。

ストアド プロシージャには、最大で1024個のパラメータを含めることができます。ただし、Teradata Databaseはこの数のパラメータを格納しサポートするものの、ODBC Driver for TeradataにはSQLBindParameterの制約があるため、257個以上のパラメータを含むストアド プロシージャを実行できません。

SQL_DATA_AT_EXECでのバインド展開に依存しているプロシージャ(マクロ)のデフォルト パラメータ(pcbValue= SQL_DEFAULT_PARAM)は、インプリメントされていません。

ANSIでは列レベルの権限が定義されているため、ODBC Driver for Teradataは、テーブルに関連付けられた列権限を返します。テーブルのすべての列に特定の権限がある場合には、ODBC Driver for Teradataは、列名として値ALLを返します。

SQLColumnsは、最大22列のテーブルやビューの列情報を返します。SQLColumns()を使用するためには、対象となる(複数の)テーブルに対するSELECT権限が必要です。

デフォルトでは、SQLDescribeColおよびSQLColAttributeは、Teradataの列タイトルの代わりに列名を返します。アプリケーションで、ODBC Driver for Teradataが実際の列名ではなく列タイトルを返すようにする場合は、使用するDSNのTeradata ODBC Driver Options(Teradata ODBCドライバ オプション)ダイアログ ボックスのUse Column Names(列名を使用する)オプションの選択を解除するか、UNIX OSでDontUseTitles = Noを設定する必要があります。

実際の列名の代わりに列タイトルを返すと、Crystal Reportsなどの一部のアプリケーションで問題が発生することがあります。これは、そのアプリケーションが、列タイトルではなく列名が返されることを想定しているためです。

SQLDescribeColおよびSQLColAttributeは、INTEGER FORMAT 99:99:99またはFLOAT FORMAT 99:99:99として定義されている結果セットの列に対してSQL型のSQL_TIMEを返します。これらの列は、SQL_C_TIMEデータか、その他の時刻データ変換可能な形式に取り込まれます。

SQLColAttributeは、列のDBC FORMATに、FORMAT ‘$$$,$$9.99’というようにドル記号が含まれている場合に、その列が通貨タイプであることを示します。この情報は、アプリケーションが結果データの形式設定をする場合に役立ちます。

SQLDescribeParamは、作成したSQL文に関連付けられているパラメータ マーカーに対応する列または式のメタデータを返します。このメタデータは、インプリメント パラメータ記述(IPD)のフィールドでも使用できます。SQLDescribeParamの詳細については、ODBCの仕様を参照してください。

SQLExecuteまたはSQLExecDirectの実行後、SQLRowCountを呼び出して、SELECT文を含むあらゆるタイプのSQL文についてのDBCアクティビティ カウントを取得できます。

移植性を考えると、アプリケーションがこの動作に依存することは望ましくありません。その他のODBCドライバは、SELECT文の後に、行数ではなく-1を返す場合があるからです。

SQLSpecialColumns()が正しく機能するのは、ビューが単一のテーブルをベースにして、その表に固有インデックスが1つしかない場合に限ります。

SQLSpecialColumns()は、テーブルで正しく動作します。

SQLStatistics()は、テーブルのインデックスに関する情報を取得し、インデックスのカーディナリティ統計値を提供します。ただし、ページ数は推測値となります。基本テーブルの場合には正しいページ数が返されます(1ページは4096バイトと仮定)が、ビューの場合は0に設定されます。

SQLStatistics()は、SQL_ENSUREが設定されている場合に限り、テーブル自体の正確なカーディナリティ統計値を返します。それ以外の場合は、基本テーブルのカーディナリティは、テーブルにある任意のインデックスの最大カーディナリティ値に設定されます(固有インデックスがある場合は、通常この値は正確です)。

ドライバがテーブルのカーディナリティ値を正確に取得するには、SELECT COUNT(*) FROM tableを指定して実行するしかないため、SQL_ENSUREはかなり遅くなります。

パラメータ値としてSQL_ENSUREが使用された関数SQLStatistics()が呼び出された場合、この関数は小さいテーブルに限り正確です。

大きなテーブルの場合、SQL_ENSUREを使用すると、そのテーブルを長期間使用できなくなることがあるので、代わりにSQL_QUICKメソッドを使うことで、大半のアプリケーションに適したカーディナリティとページ数の概算値が得られます。

Windowsでは、SQLStatistics()は、指定したテーブルのインデックス情報を返します。このため、テーブルのビューを使って読み取りや更新ができます。インデックス生成用に指定されたODBC文法準拠のユーザー定義インデックス名がレジストリー(IndexName0-9)のDSN登録項に定義されている場合は、インデックス名としてSQLStatistics()に返されるようになりました。ODBC形式の名前付きインデックスは廃止される予定なので、推奨されません。詳細については、ODBC形式の名前付きインデックス(15.00で廃止)を参照してください。

例えば、MyIndexというテーブルのインデックスを作成する際に、ODBC文法の構文に従って、MyTableというインデックス名が使用されています。

Teradata内部でテーブルのインデックスとしてMyTable001を作成しましたが、SQLStatistics()は、MyTable001ではなくMyIndexをインデックス名として返しました。これは、DSN登録項に、MyTableのこのインデックス名が含まれているからです。それ以外のPCの場合は、MyTable001がインデックス名として返されます。

ODBC Driver for Teradataは、指定されたhstmtに関する情報を結果セットとして返します。

結果セットの内容は次のとおりです。

PRIVILEGE: テーブルの権限を特定します。特定できるのは、次のいずれかの権限か、またはデータ ソース固有の権限です。

SELECT: テーブルの1つ以上の列にあるデータを取得する権限が与えられます。

INSERT: 1つ以上の列にデータある行をテーブルに新規挿入する権限が与えられます。

UPDATE:テーブルの1つ以上の列にあるデータを変更する権限が与えられます。

DELETE: テーブルから1つ以上の行を削除する権限が与えられます。

REFERENCES: 制約内(例、一意制約、参照制約、またはテーブル チェック制約)の1つ以上の列に対して参照する権限が与えられます。特定のテーブルの権限に関して、保証されている操作の範囲は、データ ソースごとに異なります。例えば、UPDATE権限は、1つのデータ ソース上の1つのテーブルにあるすべての列、および、他のデータ ソースについては権限の設定者がUPDATE権限を持っている列のみに変更許可を保証できます。