sp_createstats (Transact-SQL)sp_createstats (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure nãoAzure Synapse Analytics (SQL DW) nãoParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

Chamadas a CREATE STATISTICS instrução para criar estatísticas de coluna única em colunas que ainda não são a primeira coluna em um objeto de estatísticas.Calls the CREATE STATISTICS statement to create single-column statistics on columns that are not already the first column in a statistics object. A criação de estatísticas de coluna única aumenta o número de histogramas, o que pode melhorar estimativas de cardinalidade, planos de consulta e desempenho de consulta.Creating single-column statistics increases the number of histograms, which can improve cardinality estimates, query plans, and query performance. A primeira coluna de um objeto de estatísticas tem um histograma; outras colunas, não.The first column of a statistics object has a histogram; other columns do not have a histogram.

sp_createstats é útil para aplicativos como o benckmark, quando os tempos de execução de consulta são críticos e não podem aguardar a geração de estatísticas de coluna única pelo otimizador de consulta.sp_createstats is useful for applications such as benchmarking when query execution times are critical and cannot wait for the query optimizer to generate single-column statistics. Na maioria dos casos, não é necessário usar sp_createstats; o otimizador de consultas gera estatísticas de coluna única conforme necessário para melhorar a consulta de planos quando o AUTO_CREATE_STATISTICS opção está ativada.In most cases, it is not necessary to use sp_createstats; the query optimizer generates single-column statistics as necessary to improve query plans when the AUTO_CREATE_STATISTICS option is on.

Para obter mais informações sobre estatísticas, consulte Estatísticas.For more information about statistics, see Statistics. Para obter mais informações sobre como gerar estatísticas de coluna única, consulte o AUTO_CREATE_STATISTICS opção opções ALTER DATABASE SET (Transact-SQL).For more information about generating single-column statistics, see the AUTO_CREATE_STATISTICS option in ALTER DATABASE SET Options (Transact-SQL).

Ícone de link do tópico Convenções de sintaxe de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxeSyntax

  
sp_createstats   
    [   [ @indexonly =   ] { 'indexonly'   | 'NO' } ]   
    [ , [ @fullscan =    ] { 'fullscan'    | 'NO' } ]   
    [ , [ @norecompute = ] { 'norecompute' | 'NO' } ]  
    [ , [ @incremental = ] { 'incremental' | 'NO' } ]  

ArgumentosArguments

[ @indexonly = ] 'indexonly' Só cria estatísticas em colunas que estão em um índice existente e não a primeira coluna em qualquer definição de índice.[ @indexonly = ] 'indexonly' Creates statistics only on columns that are in an existing index and are not the first column in any index definition. indexonly está char(9) .indexonly is char(9). O padrão é NO.The default is NO.

[ @fullscan = ] 'fullscan' Usa o CREATE STATISTICS instrução com o FULLSCAN opção.[ @fullscan = ] 'fullscan' Uses the CREATE STATISTICS statement with the FULLSCAN option. FULLSCAN está char(9) .fullscan is char(9). O padrão é NO.The default is NO.

[ @norecompute = ] 'norecompute' Usa o CREATE STATISTICS instrução com o NORECOMPUTE opção.[ @norecompute = ] 'norecompute' Uses the CREATE STATISTICS statement with the NORECOMPUTE option. NORECOMPUTE está char(12) .norecompute is char(12). O padrão é NO.The default is NO.

[ @incremental = ] 'incremental' Usa o CREATE STATISTICS instrução com o INCREMENTAL = ON opção.[ @incremental = ] 'incremental' Uses the CREATE STATISTICS statement with the INCREMENTAL = ON option. Incremental está char(12) .Incremental is char(12). O padrão é NO.The default is NO.

Valores do código de retornoReturn Code Values

0 (êxito) ou 1 (falha)0 (success) or 1 (failure)

Conjuntos de resultadosResult Sets

Cada objeto de estatísticas novo tem o mesmo nome da coluna em que foi criado.Each new statistics object has the same name as the column it is created on.

ComentáriosRemarks

sp_createstats não cria nem atualiza estatísticas em colunas que são a primeira coluna em um objeto de estatísticas existente; Isso inclui a primeira coluna de estatísticas criada para índices, colunas com estatísticas de coluna única geradas com a opção AUTO_CREATE_STATISTICS e a primeira coluna de estatísticas criadas com a instrução CREATE STATISTICS.sp_createstats does not create or update statistics on columns that are the first column in an existing statistics object; This includes the first column of statistics created for indexes, columns with single-column statistics generated with AUTO_CREATE_STATISTICS option, and the first column of statistics created with the CREATE STATISTICS statement. sp_createstats não cria estatísticas nas primeiras colunas de índices desabilitados a menos que essa coluna é usada em outro índice habilitado.sp_createstats does not create statistics on the first columns of disabled indexes unless that column is used in another enabled index. sp_createstats não cria estatísticas em tabelas com um índice clusterizado desabilitado.sp_createstats does not create statistics on tables with a disabled clustered index.

Quando a tabela contém um conjunto de colunas, sp_createstats não cria estatísticas em colunas esparsas.When the table contains a column set, sp_createstats does not create statistics on sparse columns. Para obter mais informações sobre conjuntos de colunas esparsas, consulte usar conjuntos de colunas e usar colunas esparsas.For more information about column sets and sparse columns, see Use Column Sets and Use Sparse Columns.

PermissõesPermissions

Requer associação na função de banco de dados fixa db_owner.Requires membership in the db_owner fixed database role.

ExemplosExamples

A.A. Criar estatísticas de coluna única em todas as colunas qualificadasCreate single-column statistics on all eligible columns

O exemplo a seguir cria estatísticas de coluna única em todas as colunas qualificadas do banco de dados atual.The following example creates single-column statistics on all eligible columns in the current database.

EXEC sp_createstats;  
GO  

B.B. Criar estatísticas de coluna única em todas as colunas de índice qualificadasCreate single-column statistics on all eligible index columns

O exemplo a seguir cria estatísticas de coluna única em todas as colunas qualificadas que já estejam em um índice, não sendo a primeira coluna no índice.The following example creates single-column statistics on all eligible columns that are already in an index and are not the first column in the index.

EXEC sp_createstats 'indexonly';  
GO  

Consulte tambémSee Also

Estatística Statistics
CREATE STATISTICS (Transact-SQL) CREATE STATISTICS (Transact-SQL)
Opções ALTER DATABASE SET (Transact-SQL) ALTER DATABASE SET Options (Transact-SQL)
DBCC SHOW_STATISTICS (Transact-SQL) DBCC SHOW_STATISTICS (Transact-SQL)
DROP STATISTICS (Transact-SQL) DROP STATISTICS (Transact-SQL)
UPDATE STATISTICS (Transact-SQL) UPDATE STATISTICS (Transact-SQL)
Procedimentos armazenados do mecanismo de banco de dados (Transact-SQL) Database Engine Stored Procedures (Transact-SQL)
Procedimentos armazenados do sistema (Transact-SQL)System Stored Procedures (Transact-SQL)