sys.columns (Transact-SQL)sys.columns (Transact-SQL)

APLICA-SE A: simSQL Server simBanco de Dados SQL do Azure simAzure Synapse Analytics (SQL DW) simParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database yesAzure Synapse Analytics (SQL DW) yesParallel Data Warehouse

Retorna uma linha para cada coluna de um objeto que tem colunas, como exibições ou tabelas.Returns a row for each column of an object that has columns, such as views or tables. A seguir, uma lista de tipos de objeto que têm colunas.The following is a list of object types that have columns:

  • Funções de assembly com valor de tabela (FT)Table-valued assembly functions (FT)

  • Funções SQL embutidas com valor de tabela (IF)Inline table-valued SQL functions (IF)

  • Tabelas internas (IT)Internal tables (IT)

  • Tabelas do sistema (S)System tables (S)

  • Funções SQL com valor de tabela (TF)Table-valued SQL functions (TF)

  • Tabelas de usuário (U)User tables (U)

  • Exibições (V)Views (V)

Nome da colunaColumn name Tipo de dadosData type DescriçãoDescription
object_idobject_id intint ID do objeto ao qual esta coluna pertence.ID of the object to which this column belongs.
namename sysnamesysname Nome da coluna.Name of the column. É exclusiva no objeto.Is unique within the object.
column_idcolumn_id intint ID da coluna.ID of the column. É exclusiva no objeto.Is unique within the object.

Os IDs de coluna podem não ser sequenciais.Column IDs might not be sequential.
system_type_idsystem_type_id tinyinttinyint ID do tipo de sistema da coluna.ID of the system type of the column.
user_type_iduser_type_id intint ID do tipo da coluna, como definido pelo usuário.ID of the type of the column as defined by the user.

Para retornar o nome do tipo, ingresse na exibição do catálogo Sys. Types nesta coluna.To return the name of the type, join to the sys.types catalog view on this column.
max_lengthmax_length smallintsmallint Comprimento máximo (em bytes) da coluna.Maximum length (in bytes) of the column.

-1 = o tipo de dados da coluna é varchar (max) , nvarchar (max) , varbinary (max) ou XML.-1 = Column data type is varchar(max), nvarchar(max), varbinary(max), or xml.

Para colunas de texto , o valor de max_length será 16 ou o valor definido por sp_tableoption ' texto na linha '.For text columns, the max_length value will be 16 or the value set by sp_tableoption 'text in row'.
precisãoprecision tinyinttinyint Precisão da coluna se for baseada em numeric; caso contrário, 0.Precision of the column if numeric-based; otherwise, 0.
scalescale tinyinttinyint Escala da coluna se numérica; caso contrário é 0.Scale of column if numeric-based; otherwise, 0.
collation_namecollation_name sysnamesysname Nome do agrupamento da coluna se baseado em caractere; caso contrário, NULL.Name of the collation of the column if character-based; otherwise, NULL.
is_nullableis_nullable bitbit 1 = A coluna permite valor nulo.1 = Column is nullable.
is_ansi_paddedis_ansi_padded bitbit 1 = A coluna usa o comportamento ANSI_PADDING ON se for de caractere, binária, ou variante.1 = Column uses ANSI_PADDING ON behavior if character, binary, or variant.

0 = A coluna não é de caractere, binária nem variante.0 = Column is not character, binary, or variant.
is_rowguidcolis_rowguidcol bitbit 1 = A coluna é uma ROWGUIDCOL declarada.1 = Column is a declared ROWGUIDCOL.
is_identityis_identity bitbit 1 = A coluna tem valores de identidade1 = Column has identity values
is_computedis_computed bitbit 1 = A coluna é computada.1 = Column is a computed column.
is_filestreamis_filestream bitbit 1 = A coluna é uma coluna de FILESTREAM.1 = Column is a FILESTREAM column.
is_replicatedis_replicated bitbit 1 = A coluna é replicada.1 = Column is replicated.
is_non_sql_subscribedis_non_sql_subscribed bitbit 1 = A coluna tem um assinante não SQL Server.1 = Column has a non-SQL Server subscriber.
is_merge_publishedis_merge_published bitbit 1 = A coluna é publicada por mesclagem.1 = Column is merge-published.
is_dts_replicatedis_dts_replicated bitbit 1 = A coluna é replicada usando o SSISSSIS.1 = Column is replicated by using SSISSSIS.
is_xml_documentis_xml_document bitbit 1 = O conteúdo é um documento XML completo.1 = Content is a complete XML document.

0 = o conteúdo é um fragmento de documento ou o tipo de dados da coluna não é XML.0 = Content is a document fragment or the column data type is not xml.
xml_collection_idxml_collection_id intint Diferente de zero se o tipo de dados da coluna for XML e o XML for digitado.Nonzero if the data type of the column is xml and the XML is typed. O valor será a ID da coleção que contém o namespace do esquema XML de validação da coluna.The value will be the ID of the collection containing the validating XML schema namespace of the column.

0 = Nenhuma coleção de esquemas XML.0 = No XML schema collection.
default_object_iddefault_object_id intint ID do objeto padrão, independentemente de ser um objeto autônomo Sys. sp_bindefaultou uma restrição padrão em nível de coluna em linha.ID of the default object, regardless of whether it is a stand-alone object sys.sp_bindefault, or an inline, column-level DEFAULT constraint. A coluna parent_object_id de um objeto embutido padrão no nível da coluna é uma referência à própria tabela.The parent_object_id column of an inline column-level default object is a reference back to the table itself.

0 = Sem padrão.0 = No default.
rule_object_idrule_object_id intint ID da regra autônoma associada à coluna usando sys.sp_bindrule.ID of the stand-alone rule bound to the column by using sys.sp_bindrule.

0 = Nenhuma regra autônoma.0 = No stand-alone rule. Para restrições de verificação em nível de coluna, consulte Sys (. check_constraints Transact)-SQL.For column-level CHECK constraints, see sys.check_constraints (Transact-SQL).
is_sparseis_sparse bitbit 1 = A coluna é esparsa.1 = Column is a sparse column. Para obter mais informações, veja Usar colunas esparsas.For more information, see Use Sparse Columns.
is_column_setis_column_set bitbit 1 = A coluna é um conjunto de colunas.1 = Column is a column set. Para obter mais informações, veja Usar colunas esparsas.For more information, see Use Sparse Columns.
generated_always_typegenerated_always_type tinyinttinyint Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

Identifica quando o valor da coluna é gerado (sempre será 0 para colunas em tabelas do sistema):Identifies when the column value is generated (will always be 0 for columns in system tables):

0 = NOT_APPLICABLE0 = NOT_APPLICABLE

1 = AS_ROW_START1 = AS_ROW_START

2 = AS_ROW_END2 = AS_ROW_END

Para obter mais informações, consulte bancos (de dados)relacionais de tabelas temporais.For more information, see Temporal Tables (Relational databases).
generated_always_type_descgenerated_always_type_desc nvarchar(60)nvarchar(60) Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

Descrição textual do valor do generated_always_type(sempre NOT_APPLICABLE para colunas em tabelas do sistema)Textual description of generated_always_type's value (always NOT_APPLICABLE for columns in system tables)

NOT_APPLICABLENOT_APPLICABLE

AS_ROW_STARTAS_ROW_START

AS_ROW_ENDAS_ROW_END
encryption_typeencryption_type intint Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

Tipo de criptografia:Encryption type:

1 = criptografia determinística1 = Deterministic encryption

2 = criptografia aleatória2 = Randomized encryption
encryption_type_descencryption_type_desc nvarchar(64)nvarchar(64) Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

Descrição do tipo de criptografia:Encryption type description:

ALEATÓRIARANDOMIZED

DETERMINISTICDETERMINISTIC
encryption_algorithm_nameencryption_algorithm_name sysnamesysname Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

Nome do algoritmo de criptografia.Name of encryption algorithm.

Há suporte apenas para AEAD_AES_256_CBC_HMAC_SHA_512.Only AEAD_AES_256_CBC_HMAC_SHA_512 is supported.
column_encryption_key_idcolumn_encryption_key_id intint Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

ID do CEK.ID of the CEK.
column_encryption_key_database_namecolumn_encryption_key_database_name sysnamesysname Aplica-se a: SQL Server 2016 (13.x)SQL Server 2016 (13.x) e posterior, Banco de Dados SQLSQL Database.Applies to: SQL Server 2016 (13.x)SQL Server 2016 (13.x) and later, Banco de Dados SQLSQL Database.

O nome do banco de dados em que a chave de criptografia de coluna existe se for diferente do banco de dados da coluna.The name of the database where the column encryption key exists if different than the database of the column. NULL se a chave existir no mesmo banco de dados que a coluna.NULL if the key exists in the same database as the column.
is_hiddenis_hidden bitbit Aplica-se a: SQL ServerSQL Server e posterior, Banco de Dados SQLSQL Database.Applies to: SQL ServerSQL Server and later, Banco de Dados SQLSQL Database.

Indica se a coluna está oculta:Indicates if the column is hidden:

0 = regular, não-oculta, coluna visível0 = regular, not-hidden, visible column

1 = coluna oculta1 = hidden column
is_maskedis_masked bitbit Aplica-se a: SQL ServerSQL Server e posterior, Banco de Dados SQLSQL Database.Applies to: SQL ServerSQL Server and later, Banco de Dados SQLSQL Database.

Indica se a coluna é mascarada por uma máscara de dados dinâmicos:Indicates if the column is masked by a dynamic data masking:

0 = coluna regular, não mascarada0 = regular, not-masked column

1 = a coluna está mascarada1 = column is masked

PermissõesPermissions

A visibilidade dos metadados em exibições do catálogo está limitada aos protegíveis que pertencem a um usuário ou para os quais o usuário recebeu permissão.The visibility of the metadata in catalog views is limited to securables that a user either owns or on which the user has been granted some permission. Para obter mais informações, consulte Metadata Visibility Configuration.For more information, see Metadata Visibility Configuration.

Consulte tambémSee Also

do Transact- (SQL) de exibições do sistemaSystem Views (Transact-SQL)
Exibições de catálogo de objeto(Transact-SQL) Object Catalog Views (Transact-SQL)
Exibições de catálogo (Transact-SQL) Catalog Views (Transact-SQL)
Consultando as perguntas frequentes sobre o catálogo do sistema SQL Server Querying the SQL Server System Catalog FAQ
sys.all_columns (Transact-SQL) sys.all_columns (Transact-SQL)
sys.system_columns (Transact-SQL)sys.system_columns (Transact-SQL)