適合 性
導入版:ODBC 1.0 規格準拠:ODBC
まとめ
SQLTablePrivileges はテーブルのリストと各テーブルに関連付けられた権限を返します。 ドライバーは指定された文の結果セットとして情報を返します。
Syntax
SQLRETURN SQLTablePrivileges(
SQLHSTMT StatementHandle,
SQLCHAR * CatalogName,
SQLSMALLINT NameLength1,
SQLCHAR * SchemaName,
SQLSMALLINT NameLength2,
SQLCHAR * TableName,
SQLSMALLINT NameLength3);
引数
StatementHandle
[入力]ステートメント ハンドル。
CatalogName
[入力]テーブルカタログ。 ドライバが一部のテーブルにはカタログをサポートしているが、他のテーブルではサポートしない場合(例えば異なるDBMSからデータを取得する場合など)、空文字列(「」)はカタログを持たないテーブルを示します。
CatalogNameは 文字列検索パターンを含めません。
SQL_ATTR_METADATA_ID文属性がSQL_TRUEに設定されている場合、 CatalogName は識別子として扱われ、その大文字は重要ではありません。 もしSQL_FALSEであれば、 カタログ名 は通常の引数となります。文字通りに扱われており、そのケースは重要です。 詳細については、「カタログ関数の引数」を参照してください。
NameLength1
[入力]*カタログ名の文字数。
SchemaName
[入力]スキーマ名の文字列検索パターン。 ドライバが一部のテーブルにはスキーマをサポートし、他のテーブルにはサポートしない場合(例えば異なるDBMSからデータを取得する場合など)、空の文字列(「」)はスキーマを持たないテーブルを示します。
SQL_ATTR_METADATA_ID文属性がSQL_TRUEに設定されている場合、 SchemaName は識別子として扱われ、その大文字は重要ではありません。 SQL_FALSEの場合、 SchemaName はパターンの値の引数となります。文字通りに扱われており、そのケースは重要です。
NameLength2
[入力]*SchemaNameの文字数。
テーブル名
[入力]テーブル名の文字列検索パターン。
SQL_ATTR_METADATA_ID文属性がSQL_TRUEに設定されている場合、 TableName は識別子として扱われ、その大文字は重要ではありません。 SQL_FALSEの場合、 TableName はパターン値の引数となります。文字通りに扱われており、そのケースは重要です。
NameLength3
[入力]*TableNameの文字数。
返品
SQL_SUCCESS、SQL_SUCCESS_WITH_INFO、SQL_STILL_EXECUTING、SQL_ERROR、またはSQL_INVALID_HANDLE。
Diagnostics
SQLTablePrivilegesがSQL_ERRORまたはSQL_SUCCESS_WITH_INFOを返すと、SQLGetDiagRecを呼び出してHandleTypeをSQL_HANDLE_STMT、HandleをStatementHandleで呼び出すことで関連するSQLSTATE値を取得できます。 以下の表は 、SQLTablePrivileges によって一般的に返されるSQLSTATEの値と、それぞれをこの関数の文脈で説明しています。「(DM)」という表記は、ドライバーマネージャーが返すSQLstateの記述の前に記載されます。 特に明記されていない限り、各 SQLSTATE 値に関連付けられている戻りコードはSQL_ERROR。
| SQLSTATE | エラー | Description |
|---|---|---|
| 01000 | 一般的な警告 | ドライバー固有の情報メッセージ。 (関数はSQL_SUCCESS_WITH_INFOを返します。 |
| 08S01 | 通信リンクエラー | ドライバーとドライバーが接続されたデータ ソース間の通信リンクは、関数の処理が完了する前に失敗しました。 |
| 24000 | カーソル状態が無効 |
StatementHandle上のカーソルが開かれ、SQLFetchまたはSQLFetchScrollが呼び出されていました。 このエラーは、SQLFetchまたはSQLFetchScrollが返SQL_NO_DATA返さない場合、ドライバーから返SQL_NO_DATA返されます。 StatementHandleにはカーソルが開かれていましたが、SQLFetchやSQLFetchScrollは呼び出されていませんでした。 |
| 40001 | シリアル化エラー | 別のトランザクションでリソースのデッドロックが発生したため、トランザクションがロールバックされました。 |
| 40003 | ステートメントの入力候補が不明です | この関数の実行中に関連付けられた接続が失敗し、トランザクションの状態を特定できません。 |
| HY000 | 一般的なエラー | 特定の SQLSTATE がなく、実装固有の SQLSTATE が定義されていないエラーが発生しました。 *MessageText バッファー内の SQLGetDiagRec によって返されるエラー メッセージには、エラーとその原因が記述されています。 |
| HY001 | メモリ割り当てエラー | ドライバーは、関数の実行または完了をサポートするために必要なメモリを割り当てませんでした。 |
| HY008 | 操作が取り消されました |
StatementHandle に対して非同期処理が有効になりました。
SQLTablePrivileges関数が呼び出され、実行が完了する前にStatementHandle上でSQLCancelまたはSQLCancelHandleが呼び出されました。 その後、StatementHandle上で再びSQLTablePrivileges関数が呼び出されました。 SQLTablePrivileges関数が呼び出され、実行が完了する前に、マルチスレッドアプリケーションの別のスレッドからStatementHandleに対してSQLCancelまたはSQLCancelHandleが呼び出されました。 |
| HY009 | null ポインターの使用が無効です | SQL_ATTR_METADATA_ID文属性はSQL_TRUEに設定され、 CatalogName の引数はnullポインタであり、SQL_CATALOG_NAME InfoType はカタログ名がサポートされていることを返します。 (DM) SQL_ATTR_METADATA_ID文属性がSQL_TRUEに設定され、 SchemaName または TableName の引数はnullポインタでした。 |
| HY010 | 関数シーケンス エラー | (DM) StatementHandle に関連付けられている接続ハンドルに対して非同期実行関数が呼び出されました。 この非同期関数は SQLTablePrivileges 関数が呼び出された時点でも実行中でした。 (DM) SQLExecute、 SQLExecDirect、または SQLMoreResultsStatementHandle が呼び出され、SQL_PARAM_DATA_AVAILABLEが返されました。 この関数は、すべてのストリーミング パラメーターのデータが取得される前に呼び出されました。 (DM) 非同期実行関数 (この関数ではない) が StatementHandle に対して呼び出されこの関数が呼び出されたときにはまだ実行されていました。 (DM) SQLExecute、 SQLExecDirect、 SQLBulkOperations、または SQLSetPos が StatementHandle に対して呼び出され、SQL_NEED_DATAが返されました。 この関数は、すべての実行時データ パラメーターまたは列に対してデータが送信される前に呼び出されました。 |
| HY013 | メモリ管理エラー | メモリが不足している可能性があるため、基になるメモリ オブジェクトにアクセスできなかったため、関数呼び出しを処理できませんでした。 |
| HY090 | 文字列またはバッファーの長さが無効です | (DM) 名前の長さの引数のうちの一つの値は0未満で、SQL_NTSと等しくなかった。 名前の長さの引数のうち1つの値が、対応する修飾子または名前の最大長さ値を超えていました。 |
| HY117 | 不明なトランザクション状態のため、接続が中断されます。 切断関数と読み取り専用関数のみが許可されます。 | (DM) 停止状態の詳細については、 SQLEndTran関数を参照してください。 |
| HYC00 | 省略可能な機能が実装されていません | カタログが指定されており、ドライバーやデータソースはカタログをサポートしていません。 スキーマが指定され、ドライバーやデータソースはスキーマをサポートしていません。 テーブルスキーマ、テーブル名、または列名に対して文字列検索パターンが指定されており、データソースはこれらの引数の一つ以上の検索パターンをサポートしていません。 SQL_ATTR_CONCURRENCY属性とSQL_ATTR_CURSOR_TYPE ステートメント属性の現在の設定の組み合わせは、ドライバーまたはデータ ソースではサポートされていませんでした。 SQL_ATTR_USE_BOOKMARKS ステートメント属性はSQL_UB_VARIABLEに設定され、SQL_ATTR_CURSOR_TYPE ステートメント属性は、ドライバーがブックマークをサポートしていないカーソルの種類に設定されました。 |
| HYT00 | タイムアウトの期限が切れました | データ ソースが結果セットを返す前に、クエリのタイムアウト期間が期限切れになりました。 タイムアウト期間は、SQL_ATTR_QUERY_TIMEOUT SQLSetStmtAttr によって設定されます。 |
| HYT01 | 接続がタイムアウトしました | データ ソースが要求に応答する前に、接続タイムアウト期間の有効期限が切れています。 接続タイムアウト期間は、SQL_ATTR_CONNECTION_TIMEOUT SQLSetConnectAttr によって設定されます。 |
| IM001 | ドライバーは、この関数をサポートしていません | (DM) StatementHandle に関連付けられているドライバーは、関数をサポートしていません。 |
| IM017 | 非同期通知モードでポーリングが無効になっている | 通知モデルが使用されるたびに、ポーリングは無効になります。 |
| IM018 | SQLCompleteAsync は、このハンドルに対する前の非同期操作を完了するために呼び出されていません。 | ハンドルに対する前の関数呼び出しがSQL_STILL_EXECUTINGを返し、通知モードが有効になっている場合は、後処理を実行して操作を完了するために、 SQLCompleteAsync をハンドルで呼び出す必要があります。 |
Comments
SchemaNameとTableNameの引数は検索パターンを受け入れます。 有効な検索パターンの詳細については、「 パターン値引数」を参照してください。
SQLTablePrivileges は、TABLE_CAT、TABLE_SCHEM、TABLE_NAME、PRIVILEGE、GRANTEEの順に並べた標準の結果セットとして結果を返します。
TABLE_CAT、TABLE_SCHEM、TABLE_NAMEの各列の実際の長さを判定するために、アプリケーションはSQL_MAX_CATALOG_NAME_LEN、SQL_MAX_SCHEMA_NAME_LEN、SQL_MAX_TABLE_NAME_LENのオプションで SQLGetInfo を呼び出すことができます。
注
ODBC カタログ関数の一般的な使用方法、引数、および返されるデータの詳細については、「 カタログ関数」を参照してください。
ODBC 3.x では、次の列の名前が変更されました。 カラム名の変更は後方互換性には影響しません。なぜならアプリケーションはカラム番号でバインドするからです。
| ODBC 2.0 列 | ODBC 3.x 列 |
|---|---|
| TABLE_QUALIFIER | TABLE_CAT |
| テーブルの所有者 | TABLE_SCHEM |
次の表に、結果セットの列を示します。 7列(IS_GRANTABLE)を超える追加の列はドライバーによって定義できます。 アプリケーションは、明示的な順序位置を指定するのではなく、結果セットの末尾からカウントダウンすることでドライバー固有の列にアクセスするべきです。 詳細については、「 カタログ関数によって返されるデータ」を参照してください。
| 列名 | 列番号 | データの種類 | Comments |
|---|---|---|---|
| TABLE_CAT(ODBC 1.0) | 1 | Varchar | カタログ名;データソースに適用できない場合はNULLです。 ドライバが一部のテーブルにはカタログをサポートしているが、他のテーブルではサポートしない場合(例えば異なるDBMSからデータを取得する場合など)、カタログを持たないテーブルに対して空の文字列("")を返します。 |
| TABLE_SCHEM(ODBC 1.0) | 2 | Varchar | スキーマ名;データソースに適用できない場合はNULLです。 ドライバが一部のテーブルにはスキーマをサポートしているが、他のテーブルではサポートしない場合、例えば異なるDBMSからデータを取得する場合、スキーマを持たないテーブルに対して空の文字列("")を返します。 |
| TABLE_NAME(ODBC 1.0) | 3 | ヴァルチャーはNULLではありません | テーブル名。 |
| GRANTOR(ODBC 1.0) | 4 | Varchar | 権限を付与したユーザーの名前;データソースに適用できない場合はNULLです。 GRANTEE列の値がオブジェクトの所有者であるすべての行では、GRANTOR列は「_SYSTEM」となります。 |
| 受給者(ODBC 1.0) | 5 | ヴァルチャーはNULLではありません | その特権が付与されたユーザーの名前。 |
| 特権(ODBC 1.0) | 6 | ヴァルチャーはNULLではありません | テーブルの特権。 以下のいずれか、またはデータソース固有の特権である場合があります。 SELECT:譲受者はテーブルの1つ以上の列のデータを取得することが許可されています。 INSERT: 譲受人は1列以上のデータを含む新しい行をテーブルに挿入することが許可されています。 UPDATE: 譲受人はテーブルの1つ以上の列のデータ更新が許可されています。 DELETE: 譲受人はテーブルからデータの行を削除することが許されています。 参照:受助者は制約(例:一意、参照、テーブルチェック制約)内でテーブルの1つ以上の列を参照することが許されています。 特定のテーブル権限によって譲受人が許可される行動範囲は、データソースに依存します。 例えば、 UPDATE 権限は、助成者が1つのデータソースのテーブル内のすべての列を更新し、別のデータソースに対して UPDATE 権限を持つ列のみを更新できるようにする場合があります。 |
| IS_GRANTABLE(ODBC 1.0) | 7 | Varchar | 受領者が他の利用者に特権を付与できるかどうかを示します。「はい」「NO」、またはデータソースに該当しない不明または適用できない場合はNULLと表示します。 特権は付与可能か否かのどちらかであり、両方ではありません。 SQLColumnPrivilegesが返す結果セットには、IS_GRANTABLE列以外のすべての列が同じ値を持つ2行は決して含まれません。 |
コード例
類似の関数のコード例については 、SQLColumnsを参照してください。
関連関数
| 詳細情報 | 参照先 |
|---|---|
| 結果セット内の列へのバッファーのバインド | SQLBindCol 関数 |
| ステートメント処理の取り消し | SQLCancel 関数 |
| コラムまたは複数のコラムの返還権限 | SQLColumnPrivileges 関数 |
| テーブルまたは複数のテーブルの列を返す | SQLColumns 関数 |
| 順方向に単一行またはデータブロックを取得する方法 | SQLFetch 関数 |
| データブロックのフェッチまたは結果セットのスクロール | SQLFetchScroll 関数 |
| 表の統計と指数の返還 | SQLStatistics 関数 |
| データソース内のテーブル一覧の返還 | SQLTables 関数 |