SQLPrimaryKeysSQLPrimaryKeys

適用対象: ○SQL Server ○Azure SQL Database ○Azure SQL Data Warehouse ○Parallel Data WarehouseAPPLIES TO: yesSQL Server yesAzure SQL Database yesAzure SQL Data Warehouse yesParallel Data Warehouse

または、一意の行識別子として使用できる複数の列をテーブルとして使用することがあり、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 関数SQLSpecialColumnsレポート行の主キーのないテーブルの識別子の候補とします。The ODBC function SQLSpecialColumns reports row identifier candidates for tables without primary keys.

SQLPrimaryKeys は値が存在するかどうかに関係なく SQL_SUCCESS を返しますCatalogNameSchemaName、またはTableNameパラメーター。SQLPrimaryKeys returns SQL_SUCCESS whether or not values exist for CatalogName, SchemaName, or TableName parameters. これらのパラメーターに無効な値を使用する場合は、SQL_NO_DATA が返さ SQLFetch します。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 ドライバーでは、リンク サーバー上のテーブルに関する情報のレポートをサポートの 2 つの部分名をそのまま使用して、 CatalogNameパラメーター。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