sp_tables_ex (Transact-SQL)

  • Artículo

Se aplica a:SQL Server

Devuelve información de tabla acerca de las tablas del servidor vinculado especificado.

Convenciones de sintaxis de Transact-SQL

Sintaxis

sp_tables_ex
    [ @table_server = ] N'table_server'
    [ , [ @table_name = ] N'table_name' ]
    [ , [ @table_schema = ] N'table_schema' ]
    [ , [ @table_catalog = ] N'table_catalog' ]
    [ , [ @table_type = ] N'table_type' ]
    [ , [ @fUsePattern = ] fUsePattern ]
[ ; ]

Argumentos

[ @table_server = ] N'table_server'

Nombre del servidor vinculado para el que se va a devolver información de la tabla. @table_server es sysname, sin ningún valor predeterminado.

[ @table_name = ] N'table_name'

Nombre de la tabla para la que se va a devolver información de tipo de datos. @table_name es sysname, con un valor predeterminado de NULL.

[ @table_schema = ] N'table_schema'

Esquema de tabla. @table_schema es sysname, con un valor predeterminado de NULL.

[ @table_catalog = ] N'table_catalog'

Nombre de la base de datos en la que reside el table_name especificado. @table_catalog es sysname, con un valor predeterminado de NULL.

[ @table_type = ] N'table_type'

Tipo de la tabla que se va a devolver. @table_type es sysname y puede tener uno de los valores siguientes.

Value Descripción
ALIAS Nombre de un alias.
GLOBAL TEMPORARY Nombre de una tabla temporal disponible en todo el sistema.
LOCAL TEMPORARY Nombre de una tabla temporal disponible solo para el trabajo actual.
SYNONYM Nombre de un sinónimo.
SYSTEM TABLE Nombre de una tabla del sistema.
SYSTEM VIEW Nombre de una vista del sistema.
TABLE Nombre de una tabla de usuario.
VIEW Nombre de una vista.

[ @fUsePattern = ] fUsePattern

Determina si los caracteres _, %, [y ] se interpretan como caracteres comodín. Los valores válidos son 0 (coincidencia de patrón desactivada) y 1 (coincidencia de patrón activada). @fUsePattern es bit, con un valor predeterminado de 1.

Valores de código de retorno

Ninguno.

Conjunto de resultados

Nombre de la columna Tipo de datos Descripción
TABLE_CAT sysname Nombre del calificador de la tabla. Varios productos de DBMS admiten la nomenclatura de tres partes para tablas (<qualifier>.<owner>.<name>). En SQL Server, esta columna representa el nombre de la base de datos. En otros productos, representa el nombre del servidor del entorno de base de datos de la tabla. Este campo puede ser NULL.
TABLE_SCHEM sysname Nombre del propietario. En SQL Server, esta columna representa el nombre del usuario de la base de datos que creó la tabla. Este campo siempre devuelve un valor.
TABLE_NAME sysname Nombre de la tabla. Este campo siempre devuelve un valor.
TABLE_TYPE varchar(32) Tabla, tabla del sistema o vista.
REMARKS varchar(254) SQL Server no devuelve un valor para esta columna.

Comentarios

sp_tables_ex se ejecuta consultando el conjunto de filas TABLES de la IDBSchemaRowset interfaz del proveedor OLE DB correspondiente a table_server. Los parámetros table_name, table_schema, table_catalog y column se pasan a esta interfaz para restringir las filas devueltas.

sp_tables_ex devuelve un conjunto de resultados vacío si el proveedor OLE DB del servidor vinculado especificado no admite el TABLES conjunto de filas de la IDBSchemaRowset interfaz.

Permisos

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

Ejemplos

En el siguiente ejemplo se devuelve información sobre las tablas contenidas en el esquema HumanResources de la base de datos AdventureWorks2022 del servidor vinculado LONDON2.

EXEC sp_tables_ex @table_server = 'LONDON2',
@table_catalog = 'AdventureWorks2022',
@table_schema = 'HumanResources',
@table_type = 'TABLE';

Contenido relacionado