sp_statistics (Transact-SQL)
Devuelve una lista de todos los índices y estadísticas de una vista indizada o tabla especificada.
.gif "Icono de vínculo a temas")
Sintaxis
sp_statistics [ @table_name = ] 'table_name'
[ , [ @table_owner = ] 'owner' ]
[ , [ @table_qualifier = ] 'qualifier' ]
[ , [ @index_name = ] 'index_name' ]
[ , [ @is_unique = ] 'is_unique' ]
[ , [ @accuracy = ] 'accuracy' ]
Argumentos
[ @table_name= ] 'table_name'
Especifica la tabla que se utiliza para devolver información de catálogo. table_name es de tipo sysname y no tiene ningún valor predeterminado. No se admite la coincidencia de patrón de caracteres comodín.[ @table_owner= ] 'owner'
Es el nombre del propietario de la tabla que se utiliza para devolver información de catálogo. table_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 es propietario de una tabla en la que se especifica el nombre, se devuelven los índices 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 de name especificado que pertenezca al propietario de la base de datos. Si existe una, se devuelven los índices de esa tabla.
[ @table_qualifier= ] 'qualifier'
Es el nombre del calificador de la tabla. qualifier es de tipo sysname y su valor predeterminado es NULL. Varios productos DBMS admiten nombres de tablas formados por tres componentes: (qualifier**.owner.**name). En SQL Server, este parámetro 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.[ @index_name= ] 'index_name'
Es el nombre del índice. index_name es de tipo sysname y su valor predeterminado es %. Se admite la coincidencia de patrón de caracteres comodín.[ @is_unique= ] 'is_unique'
Indica si sólo se devolverán índices únicos (si es Y). is_unique es de tipo char(1) y su valor predeterminado es N.[ @accuracy= ] 'accuracy'
Es el nivel de cardinalidad y la precisión de página de las estadísticas. accuracy es de tipo char(1) y su valor predeterminado es Q. Especifique E para asegurarse de que las estadísticas se actualizan para que la cardinalidad y las páginas sean precisas.El valor E (SQL_ENSURE) pide al controlador que recupere las estadísticas de forma incondicional.
El valor Q (SQL_QUICK) pide al controlador que recupere la cardinalidad y las páginas sólo si están siempre disponibles desde el servidor. En este caso, el controlador no garantiza que los valores sean actuales. Las aplicaciones que están escritas en el estándar Open Group siempre adoptarán el comportamiento de SQL_QUICK de los controladores compatibles con ODBC 3x.
Conjuntos de resultados
Nombre de columna |
Tipo de datos |
Descripción |
|---|---|---|
TABLE_QUALIFIER |
sysname |
Nombre del calificador de la tabla. Esta columna puede ser NULL. |
TABLE_OWNER |
sysname |
Nombre del propietario de la tabla. Esta columna siempre devuelve un valor. |
TABLE_NAME |
sysname |
Nombre de la tabla. Esta columna siempre devuelve un valor. |
NON_UNIQUE |
smallint |
NOT NULL. 0 = Único 1 = No único |
INDEX_QUALIFIER |
sysname |
Nombre del propietario del índice. Algunos productos DBMS permiten crear índices a usuarios que no sean los propietarios de la tabla. En SQL Server, esta columna es siempre igual que TABLE_NAME.. |
INDEX_NAME |
sysname |
Es el nombre del índice. Esta columna siempre devuelve un valor. |
TYPE |
smallint |
Esta columna siempre devuelve un valor: 0 = Estadísticas de una tabla 1 = Agrupado 2 = En hash 3 = No agrupado |
SEQ_IN_INDEX |
smallint |
Posición de la columna dentro del índice. |
COLUMN_NAME |
sysname |
Nombre de cada columna del TABLE_NAME devuelto. Esta columna siempre devuelve un valor. |
COLLATION |
char(1) |
Orden utilizado en la intercalación. Puede ser: A = Ascendente D = Descendente NULL = No aplicable |
CARDINALITY |
int |
Número de filas de la tabla o de valores únicos del índice. |
PAGES |
int |
Número de páginas para el almacenamiento del índice o tabla. |
FILTER_CONDITION |
varchar(128) |
SQL Server no devuelve ningún valor. |
Valores de código de retorno
Ninguno
Notas
Los índices del conjunto de resultados aparecen ordenados, de forma ascendente, por las columnas NON_UNIQUE, TYPE, INDEX_NAME y SEQ_IN_INDEX.
El tipo de índice agrupado hace referencia a un índice en el que los datos de la tabla se almacenan en el orden del índice. Esto corresponde a los índices agrupados de SQL Server.
El tipo de índice en hash acepta búsquedas de coincidencia exacta o de intervalos, pero las búsquedas de coincidencia de patrón no utilizan el índice.
sp_statistics es equivalente a SQLStatistics en ODBC. Los resultados devueltos se ordenan por NON_UNIQUE, TYPE, INDEX_QUALIFIER, INDEX_NAME y SEQ_IN_INDEX. Para obtener más información, vea la Referencia de la API de ODBC.
Permisos
Requiere el permiso SELECT en el esquema.