sp_columns (Transact-SQL)

Sintaxis

sp_columns [ @table_name = ] object  [ , [ @table_owner = ] owner ] 
     [ , [ @table_qualifier = ] qualifier ] 
     [ , [ @column_name = ] column ] 
     [ , [ @ODBCVer = ] ODBCVer ]

Argumentos

• [ @table_name=] object
  Es el nombre de la tabla o de la vista que se utiliza para devolver información del catálogo. object_name es de tipo nvarchar(384) y no tiene ningún valor predeterminado. Se admite la coincidencia de patrón de caracteres comodín.

• [ @table_owner=] owner
  Es el propietario del objeto de la tabla o vista utilizada para devolver información del catálogo. owner es de tipo nvarchar(384) y su valor predeterminado es NULL. Se admite la coincidencia de patrón de caracteres comodín. Si no se especifica owner, se aplican las reglas predeterminadas de visibilidad de la tabla o de la vista del DBMS subyacente.

  Si el usuario actual es propietario de una tabla o vista con el nombre especificado, se devuelven las columnas de esa tabla. Si no se especifica owner y el usuario actual no es propietario de ninguna tabla o vista con el valor especificado para object, sp_columns buscará una tabla o una vista que contenga el valor especificado para object y que pertenezca al propietario de la base de datos. Si hay una, se devuelven las columnas de esa tabla.

• [ @table_qualifier=] qualifier
  Es el nombre del calificador de la tabla o la vista. 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.

• [ @column_name=] column
  Es una sola columna y se utiliza cuando sólo se desea una columna de información del catálogo. column es de tipo nvarchar(384) y su valor predeterminado es NULL. Si no se especifica el parámetro column, se devolverán todas las columnas. En SQL Server, column representa el nombre de la columna que aparece en la tabla syscolumns. Se admite la coincidencia de patrón de caracteres comodín. Para obtener una interoperabilidad máxima, el cliente de puerta de enlace sólo debe dar por supuesta la coincidencia de patrón estándar de SQL-92 (caracteres comodín % y _).

• [ @ODBCVer=] ODBCVer
  Es la versión de ODBC que se está utilizando. ODBCVer es de tipo int y su valor predeterminado es 2. Esto indica que la versión de ODBC es la 2. Los valores válidos son 2 ó 3. Para analizar las diferencias de comportamiento entre la versión 2 y la versión 3, vea la especificación SQLColumns de ODBC.

Valores de código de retorno

Ninguno

Conjuntos de resultados

El procedimiento almacenado de catálogo sp_columns equivale a SQLColumns en ODBC. Los resultados devueltos se ordenan por TABLE_QUALIFIER, TABLE_OWNER y TABLE_NAME.

1 Para obtener más información, vea la documentación de Microsoft ODBC.

Permisos

Es necesario contar con un permiso de tipo SELECT sobre el esquema.

Notas

sp_columns sigue los requisitos de los identificadores delimitados. Para obtener más información, vea Identificadores delimitados (motor de base de datos).

Ejemplos

En el ejemplo siguiente se devuelve información de columna para una tabla especificada.

USE AdventureWorks
GO
EXEC sp_columns @table_name = N'Department',
   @table_owner = N'HumanResources';

Vea también

Referencia