SQLPrimaryKeys

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Una tabla puede tener una columna o columnas que pueden servir como identificadores de fila únicos y las tablas creadas sin una restricción PRIMARY KEY devuelven un conjunto de resultados vacío a SQLPrimaryKeys. La función ODBC SQLSpecialColumns notifica los candidatos de identificador de fila para las tablas sin claves principales.

SQLPrimaryKeys devuelve SQL_SUCCESS si existen o no valores para los parámetros CatalogName, SchemaName o TableName . SQLFetch devuelve SQL_NO_DATA si se usan valores no válidos en estos parámetros.

SQLPrimaryKeys se puede ejecutar en un cursor de servidor estático. Un intento de ejecutar SQLPrimaryKeys en un cursor actualizable (dinámico o conjunto de claves) devolverá SQL_SUCCESS_WITH_INFO que indica que se ha cambiado el tipo de cursor.

El controlador ODBC de SQL Server Native Client admite la información de informes de tablas en servidores vinculados aceptando un nombre de dos partes para el parámetro CatalogName: Linked_Server_Name.Catalog_Name.

SQLPrimaryKeys y parámetros con valores de tabla

Si el atributo de instrucción SQL_SOPT_SS_NAME_SCOPE tiene el valor SQL_SS_NAME_SCOPE_TABLE_TYPE, en lugar de su valor predeterminado de SQL_SS_NAME_SCOPE_TABLE, SQLPrimaryKeys devolverá información sobre las columnas de clave principal de los tipos de tabla. Para obtener más información sobre SQL_SOPT_SS_NAME_SCOPE, vea SQLSetStmtAttr.

Para obtener más información sobre los parámetros con valores de tabla, vea Parámetros con valores de tabla (ODBC).

Consulte también

Función SQLPrimaryKeys
ODBC API Implementation Details