SQLPrimaryKeysSQLPrimaryKeys

適用対象: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

テーブルには、一意の行識別子として使用できる1つ以上の列が含まれる場合があります。また、PRIMARY KEY 制約なしで作成されたテーブルは、SQLPrimaryKeys に空の結果セットを返します。A table might have a column or columns that can serve as unique row identifiers, and tables created without a PRIMARY KEY constraint return an empty result set to SQLPrimaryKeys. ODBC 関数sqlの列は、主キーのないテーブルの行識別子の候補を報告します。The ODBC function SQLSpecialColumns reports row identifier candidates for tables without primary keys.

SQLPrimaryKeys は、 CatalogNameSchemaName、またはTableNameパラメーターの値が存在するかどうかを SQL_SUCCESS 返します。SQLPrimaryKeys returns SQL_SUCCESS whether or not values exist for CatalogName, SchemaName, or TableName parameters. これらのパラメーターで無効な値が使用されている場合、SQLFetch は SQL_NO_DATA を返します。SQLFetch returns SQL_NO_DATA when invalid values are used in these parameters.

SQLPrimaryKeys は、静的サーバーカーソルで実行できます。SQLPrimaryKeys can be executed on a static server cursor. 更新可能なカーソル (動的カーソルまたはキーセットカーソル) で SQLPrimaryKeys を実行しようとすると、カーソルの種類が変更されたことを示す SQL_SUCCESS_WITH_INFO が返されます。An attempt to execute SQLPrimaryKeys on an updatable (dynamic or keyset) cursor will return SQL_SUCCESS_WITH_INFO indicating that the cursor type has been changed.

SQL ServerSQL Server Native Client ODBC ドライバーでは、 CatalogNameパラメーターの2部構成の名前を使用して、リンクサーバー上のテーブルの情報をレポートすることができます。 Linked_Server_Name Catalog_Nameです。The SQL ServerSQL Server Native Client ODBC driver supports reporting information for tables on linked servers by accepting a two-part name for the CatalogName parameter: Linked_Server_Name.Catalog_Name.

SQLPrimaryKeys とテーブル値パラメーターSQLPrimaryKeys and Table-Valued Parameters

ステートメント属性 SQL_SOPT_SS_NAME_SCOPE の値が既定値の SQL_SS_NAME_SCOPE_TABLE ではなく SQL_SS_NAME_SCOPE_TABLE_TYPE の場合、SQLPrimaryKeys はテーブル型の主キー列に関する情報を返します。If the statement attribute SQL_SOPT_SS_NAME_SCOPE has the value SQL_SS_NAME_SCOPE_TABLE_TYPE, rather than its default value of SQL_SS_NAME_SCOPE_TABLE, SQLPrimaryKeys will return information about primary key columns of table types. SQL_SOPT_SS_NAME_SCOPE の詳細については、「 SQLSetStmtAttr」を参照してください。For more information on SQL_SOPT_SS_NAME_SCOPE, see SQLSetStmtAttr.

テーブル値パラメーターの詳細については、「テーブル値パラメーター (の)ODBC」を参照してください。For more information about table-valued parameters, see Table-Valued Parameters (ODBC).

参照See Also

Sqlprimarykeys 関数 SQLPrimaryKeys Function
ODBC API 実装の詳細ODBC API Implementation Details