sp_pkeys (Transact-SQL)
Devuelve la información de clave principal de una única tabla en el entorno actual.
Se aplica a: SQL Server (SQL Server 2008 a versión actual), Windows Azure SQL Database (Versión inicial a versión actual). |
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
sp_pkeys [ @table_name = ] 'name'
[ , [ @table_owner = ] 'owner' ]
[ , [ @table_qualifier = ] 'qualifier' ]
Argumentos
[ @table\_name= ] 'name'
Es la tabla de la que se devuelve información. name es de tipo sysname y no tiene valor predeterminado. No se admite la coincidencia de patrón de caracteres comodín.[ @table\_owner= ] 'owner'
Especifica el propietario de la tabla especificada. owner es de tipo sysname y su valor predeterminado es NULL. No se admite la coincidencia de patrón de caracteres comodín. Si no se especifica owner, se aplican las reglas predeterminadas de visibilidad de tabla del DBMS subyacente.En SQL Server, si el usuario actual posee una tabla en la que se especifica el nombre, se devuelven las columnas de esa tabla. Si no se especifica owner y el usuario actual no es el propietario de una tabla con el valor de name especificado, este procedimiento busca una tabla con el valor name especificado que pertenezca al propietario de la base de datos. Si existe una, se devuelven las columnas de esa tabla.
[ @table\_qualifier= ] 'qualifier'
Es el calificador de la tabla. qualifier es de tipo sysname y su valor predeterminado es NULL. Varios productos DBMS admiten nombres de tres partes para las tablas (qualifier**.owner.**name). En SQL Server, esta columna representa el nombre de la base de datos. En algunos productos, representa el nombre del servidor del entorno de base de datos de la tabla.
Valores de código de retorno
Ninguno
Conjuntos de resultados
Nombre de la columna |
Tipo de datos |
Descripción |
|---|---|---|
TABLE_QUALIFIER |
sysname |
Nombre del calificador de tabla. Este campo puede ser NULL. |
TABLE_OWNER |
sysname |
Nombre del propietario de la tabla. Este campo siempre devuelve un valor. |
TABLE_NAME |
sysname |
Nombre de la tabla. En SQL Server, esta columna representa el nombre de la tabla como se muestra en la tabla sysobjects. Este campo siempre devuelve un valor. |
COLUMN_NAME |
sysname |
Nombre de la columna para cada columna devuelta de TABLE_NAME. En SQL Server, esta columna representa el nombre de columna como se muestra en la tabla sys.columns. Este campo siempre devuelve un valor. |
KEY_SEQ |
smallint |
Número de secuencia de la columna en una clave principal con varias columnas. |
PK_NAME |
sysname |
Identificador de la clave principal. Devuelve NULL si no es aplicable al origen de datos. |
Comentarios
sp_pkeys devuelve información acerca de las columnas definidas explícitamente con una restricción PRIMARY KEY. Debido a que no todos los sistemas aceptan claves principales con nombre explícito, el implementador de puerta de enlace determina qué constituye una clave principal. Observe que el término clave principal hace referencia a la clave principal lógica de una tabla. Se espera que cada clave enumerada como clave principal lógica tenga un índice único definido en la misma. Este índice único también se devuelve en sp_statistics.
El procedimiento almacenado sp_pkeys es equivalente a SQLPrimaryKeys en ODBC. Los resultados devueltos se ordenan por medio de TABLE_QUALIFIER, TABLE_OWNER, TABLE_NAME y KEY_SEQ.
Permisos
Se requiere el permiso de tipo SELECT en el esquema.
Ejemplos
En el siguiente ejemplo se recupera la clave principal de la tabla HumanResources.Department de la base de datos AdventureWorks2012.
USE AdventureWorks2012;
GO
EXEC sp_pkeys @table_name = N'Department'
,@table_owner = N'HumanResources';