Coleções de esquema do SQL Server

Artigo
05/23/2023

Aplicável a: .NET Framework .NET .NET Standard

O Provedor de Dados Microsoft SqlClient para SQL Server dá suporte a coleções de esquemas adicionais, além das coleções de esquemas comuns. As coleções de esquemas variam ligeiramente de acordo com a versão utilizada do SQL Server. Para determinar a lista de coleções de esquemas compatíveis, chame o método GetSchema sem argumentos ou com o nome da coleção de esquemas "MetaDataCollections". Isso retornará uma DataTable com uma lista de coleções de esquemas compatíveis, o número de restrições ao qual cada uma dá suporte e o número de partes de identificador usado por elas.

Bancos de dados

ColumnName	Tipo de dados	Descrição
database_name	String	Nome do banco de dados.
dbid	Int16	ID do banco de dados.
create_date	DateTime	Data de criação do banco de dados.

Chaves estrangeiras

ColumnName	Tipo de dados	Descrição
CONSTRAINT_CATALOG	String	Catálogo ao qual a restrição pertence.
CONSTRAINT_SCHEMA	String	Esquema que contém a restrição.
CONSTRAINT_NAME	String	Nome.
TABLE_CATALOG	String	Nome de tabela da qual a restrição faz parte.
TABLE_SCHEMA	String	Esquema que contém a tabela.
TABLE_NAME	String	Nome da tabela
CONSTRAINT_TYPE	String	Tipo de restrição. Somente "FOREIGN KEY" é permitido.
IS_DEFERRABLE	String	Especifica se a restrição pode ser adiada. Retorna NO.
INITIALLY_DEFERRED	String	Especifica se a restrição pode ser inicialmente adiada. Retorna NO.

Índices

ColumnName	Tipo de dados	Descrição
constraint_catalog	String	Catálogo ao qual o índice pertence.
constraint_schema	String	Esquema que contém o índice.
constraint_name	String	Nome do índice.
table_catalog	String	Nome da tabela à qual o índice está associado.
table_schema	String	Esquema que contém a tabela à qual o índice está associado.
table_name	String	Nome da tabela.
index_name	String	Nome do índice.
type_desc	String	O tipo do índice será um dos seguintes: – HEAP – CLUSTERIZADO – NÃO CLUSTERIZADO – XML – ESPACIAL

IndexColumns

ColumnName	Tipo de dados	Descrição
constraint_catalog	String	Catálogo ao qual o índice pertence.
constraint_schema	String	Esquema que contém o índice.
constraint_name	String	Nome do índice.
table_catalog	String	Nome da tabela à qual o índice está associado.
table_schema	String	Esquema que contém a tabela à qual o índice está associado.
table_name	String	Nome da tabela.
column_name	String	Nome da coluna à qual o índice está associado.
ordinal_position	Int32	Posição ordinal na coluna.
KeyType	Byte	O tipo de objeto.
index_name	String	Nome do índice.

Procedimentos

ColumnName	Tipo de dados	Descrição
SPECIFIC_CATALOG	String	Nome específico do catálogo.
SPECIFIC_SCHEMA	String	Nome específico do esquema.
SPECIFIC_NAME	String	Nome específico do catálogo.
ROUTINE_CATALOG	String	Catálogo ao qual o procedimento armazenado pertence.
ROUTINE_SCHEMA	String	Esquema que contém o procedimento armazenado.
ROUTINE_NAME	String	Nome do procedimento armazenado.
ROUTINE_TYPE	String	Retorna PROCEDURE para procedimentos armazenados e FUNCTION para funções.
CREATED	DateTime	Hora em que o procedimento foi criado.
LAST_ALTERED	DateTime	A última vez em que o procedimento foi modificado.

Parâmetros de procedimento

ColumnName	Tipo de dados	Descrição
SPECIFIC_CATALOG	String	Nome do catálogo do procedimento do qual esse é um parâmetro.
SPECIFIC_SCHEMA	String	Esquema que contém o procedimento do qual esse parâmetro faz parte.
SPECIFIC_NAME	String	Nome do procedimento do qual esse parâmetro faz parte.
ORDINAL_POSITION	Int32	A posição ordinal do parâmetro começando em 1. Para o valor retornado de um procedimento, isso é 0.
PARAMETER_MODE	String	Retorna IN no caso de um parâmetro de entrada, OUT no caso de um parâmetro de saída e INOUT no caso de um parâmetro de entrada/saída.
IS_RESULT	String	Retorna YES se indica o resultado do procedimento que é uma função. Caso contrário, retorna NO.
AS_LOCATOR	String	Retorna YES se declarado como localizador. Caso contrário, retorna NO.
PARAMETER_NAME	String	Nome do parâmetro. NULL se isto corresponder ao valor de retorno de uma função.
DATA_TYPE	String	Tipo de dados fornecido pelo sistema.
CHARACTER_MAXIMUM_LENGTH	Int32	Comprimento máximo em caracteres para tipos de dados binários ou de caractere. Caso contrário, retorna NULL.
CHARACTER_OCTET_LENGTH	Int32	Comprimento máximo em bytes para tipos de dados binários ou de caractere. Caso contrário, retorna NULL.
COLLATION_CATALOG	String	Nome do catálogo da ordenação do parâmetro. Se não for um dos tipos de caractere, retorna NULL.
COLLATION_SCHEMA	String	Sempre retorna NULL.
COLLATION_NAME	String	Nome da ordenação do parâmetro. Se não for um dos tipos de caractere, retorna NULL.
CHARACTER_SET_CATALOG	String	O nome de catálogo do conjunto de caracteres do parâmetro. Se não for um dos tipos de caractere, retorna NULL.
CHARACTER_SET_SCHEMA	String	Sempre retorna NULL.
CHARACTER_SET_NAME	String	O nome do conjunto de caracteres do parâmetro. Se não for um dos tipos de caractere, retorna NULL.
NUMERIC_PRECISION	Byte	Precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, retorna NULL.
NUMERIC_PRECISION_RADIX	Int16	Base de precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, retorna NULL.
NUMERIC_SCALE	Int32	Escala de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, retorna NULL.
DATETIME_PRECISION	Int16	Precisão em segundos fracionários se o tipo de parâmetro é datetime ou smalldatetime. Caso contrário, retorna NULL.
INTERVAL_TYPE	String	NULL. Reservado para uso futuro pelo SQL Server.
INTERVAL_PRECISION	Int16	NULL. Reservado para uso futuro pelo SQL Server.

Tabelas

ColumnName	Tipo de dados	Descrição
TABLE_CATALOG	String	Catálogo da tabela.
TABLE_SCHEMA	String	Esquema que contém a tabela.
TABLE_NAME	String	Nome da tabela.
TABLE_TYPE	String	Tipo de tabela. Pode ser VIEW ou BASE TABLE.

Colunas

ColumnName	Tipo de dados	Descrição
TABLE_CATALOG	String	Catálogo da tabela.
TABLE_SCHEMA	String	Esquema que contém a tabela.
TABLE_NAME	String	Nome da tabela.
COLUMN_NAME	String	Nome da coluna.
ORDINAL_POSITION	Int32	Número de identificação da coluna.
COLUMN_DEFAULT	String	Valor padrão da coluna
IS_NULLABLE	String	Possibilidade de nulidade da coluna. Se essa coluna permite NULL, ela retorna YES. Caso contrário, NO é retornado.
DATA_TYPE	String	Tipo de dados fornecido pelo sistema.
CHARACTER_MAXIMUM_LENGTH	Int32 – Sql8, Int16 – Sql7	Comprimento máximo, em caracteres, de dados binários, dados de caracteres e dados de texto e imagem. Caso contrário, será retornado NULL.
CHARACTER_OCTET_LENGTH	Int32 – SQL8, Int16 – Sql7	Comprimento máximo, em bytes, de dados binários, dados de caracteres e dados de texto e imagem. Caso contrário, será retornado NULL.
NUMERIC_PRECISION	Byte sem sinal	Precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
NUMERIC_PRECISION_RADIX	Int16	Base de precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
NUMERIC_SCALE	Int32	Escala de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
DATETIME_PRECISION	Int16	Código de subtipo para os tipos de dados datetime e interval do SQL-92. Para outros tipos de dados, é retornado NULL.
CHARACTER_SET_CATALOG	String	Retorna o mestre, indicando o banco de dados no qual o conjunto de caracteres está localizado, se a coluna é do tipo de dados de caractere ou de texto. Caso contrário, será retornado NULL.
CHARACTER_SET_SCHEMA	String	Sempre retorna NULL.
CHARACTER_SET_NAME	String	Retorna o nome exclusivo do conjunto de caracteres se essa coluna é do tipo de dados de caractere ou de texto. Caso contrário, será retornado NULL.
COLLATION_CATALOG	String	Retorna o mestre, indicando o banco de dados no qual a ordenação está definida, se a coluna é do tipo de dados de caractere ou de texto. Caso contrário, esta coluna será NULL.
IS_FILESTREAM	String	YES se a coluna tem o atributo FILESTREAM. NO se a coluna não tem o atributo FILESTREAM.
IS_SPARSE	String	YES se a coluna é uma coluna esparsa. NO se a coluna não é uma coluna esparsa.
IS_COLUMN_SET	String	YES se a coluna é uma coluna do conjunto de colunas. NO se a coluna não é uma coluna do conjunto de colunas.

AllColumns

A coleção de esquemas AllColumns é usada para dar suporte a colunas esparsas. AllColumns têm as mesmas restrições e o esquema DataTable resultante como a coleção de esquemas Columns. A única diferença é que AllColumns inclui colunas do conjunto de colunas que não estão incluídas na coleção de esquemas Columns. A tabela a seguir descreve essas colunas.

ColumnName	Tipo de dados	Descrição
TABLE_CATALOG	String	Catálogo da tabela.
TABLE_SCHEMA	String	Esquema que contém a tabela.
TABLE_NAME	String	Nome da tabela.
COLUMN_NAME	String	Nome da coluna.
ORDINAL_POSITION	Int32	Número de identificação da coluna.
COLUMN_DEFAULT	String	Valor padrão da coluna
IS_NULLABLE	String	Possibilidade de nulidade da coluna. Se essa coluna permite NULL, ela retorna YES. Caso contrário, será retornado NO.
DATA_TYPE	String	Tipo de dados fornecido pelo sistema.
CHARACTER_MAXIMUM_LENGTH	Int32	Comprimento máximo, em caracteres, de dados binários, dados de caracteres e dados de texto e imagem. Caso contrário, será retornado NULL.
CHARACTER_OCTET_LENGTH	Int32	Comprimento máximo, em bytes, de dados binários, dados de caracteres e dados de texto e imagem. Caso contrário, será retornado NULL.
NUMERIC_PRECISION	Byte sem sinal	Precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
NUMERIC_PRECISION_RADIX	Int16	Base de precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
NUMERIC_SCALE	Int32	Escala de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
DATETIME_PRECISION	Int16	Código de subtipo para os tipos de dados datetime e interval do SQL-92. Para outros tipos de dados, é retornado NULL.
CHARACTER_SET_CATALOG	String	Retorna o mestre, indicando o banco de dados no qual o conjunto de caracteres está localizado, se a coluna é do tipo de dados de caractere ou de texto. Caso contrário, será retornado NULL.
CHARACTER_SET_SCHEMA	String	Sempre retorna NULL.
CHARACTER_SET_NAME	String	Retorna o nome exclusivo do conjunto de caracteres se essa coluna é do tipo de dados de caractere ou de texto. Caso contrário, será retornado NULL.
COLLATION_CATALOG	String	Retorna o mestre, indicando o banco de dados no qual a ordenação está definida, se a coluna é do tipo de dados de caractere ou de texto. Caso contrário, esta coluna será NULL.
IS_FILESTREAM	String	YES se a coluna tem o atributo FILESTREAM. NO se a coluna não tem o atributo FILESTREAM.
IS_SPARSE	String	YES se a coluna é uma coluna esparsa. NO se a coluna não é uma coluna esparsa.
IS_COLUMN_SET	String	YES se a coluna é uma coluna do conjunto de colunas. NO se a coluna não é uma coluna do conjunto de colunas.

ColumnSetColumns

A coleção de esquemas ColumnSetColumns é usada para dar suporte a colunas esparsas. A coleção de esquemas ColumnSetColumns retorna o esquema para todas as colunas em um conjunto de colunas. A tabela a seguir descreve essas colunas.

ColumnName	Tipo de dados	Descrição
TABLE_CATALOG	String	Catálogo da tabela.
TABLE_SCHEMA	String	Esquema que contém a tabela.
TABLE_NAME	String	Nome da tabela.
COLUMN_NAME	String	Nome da coluna.
ORDINAL_POSITION	Int32	Número de identificação da coluna.
COLUMN_DEFAULT	String	Valor padrão da coluna
IS_NULLABLE	String	Possibilidade de nulidade da coluna. Se essa coluna permite NULL, ela retorna YES. Caso contrário, será retornado NO.
DATA_TYPE	String	Tipo de dados fornecido pelo sistema.
CHARACTER_MAXIMUM_LENGTH	Int32	Comprimento máximo, em caracteres, de dados binários, dados de caracteres e dados de texto e imagem. Caso contrário, será retornado NULL.
CHARACTER_OCTET_LENGTH	Int32	Comprimento máximo, em bytes, de dados binários, dados de caracteres e dados de texto e imagem. Caso contrário, será retornado NULL.
NUMERIC_PRECISION	Byte sem sinal	Precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
NUMERIC_PRECISION_RADIX	Int16	Base de precisão de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
NUMERIC_SCALE	Int32	Escala de dados numéricos aproximados, dados numéricos exatos, dados de inteiro ou dados monetários. Caso contrário, será retornado NULL.
DATETIME_PRECISION	Int16	Código de subtipo para os tipos de dados datetime e interval do SQL-92. Para outros tipos de dados, é retornado NULL.
CHARACTER_SET_CATALOG	String	Retorna o mestre, indicando o banco de dados no qual o conjunto de caracteres está localizado, se a coluna é do tipo de dados de caractere ou de texto. Caso contrário, será retornado NULL.
CHARACTER_SET_SCHEMA	String	Sempre retorna NULL.
CHARACTER_SET_NAME	String	Retorna o nome exclusivo do conjunto de caracteres se essa coluna é do tipo de dados de caractere ou de texto. Caso contrário, será retornado NULL.
COLLATION_CATALOG	String	Retorna o mestre, indicando o banco de dados no qual a ordenação está definida, se a coluna é do tipo de dados de caractere ou de texto. Caso contrário, esta coluna será NULL.
IS_FILESTREAM	String	YES se a coluna tem o atributo FILESTREAM. NO se a coluna não tem o atributo FILESTREAM.
IS_SPARSE	String	YES se a coluna é uma coluna esparsa. NO se a coluna não é uma coluna esparsa.
IS_COLUMN_SET	String	YES se a coluna é uma coluna do conjunto de colunas. NO se a coluna não é uma coluna do conjunto de colunas.

Usuários

ColumnName	Tipo de dados	Descrição
uid	Int16	ID do usuário ID, exclusivo neste banco de dados. 1 é o proprietário do banco de dados.
user_name	String	Nome de usuário ou nome do grupo, exclusivo neste banco de dados.
createdate	DateTime	Data em que a conta foi adicionada.
updatedate	DateTime	A data em que a conta foi alterada pela última vez.

Exibições

ColumnName	Tipo de dados	Descrição
TABLE_CATALOG	String	Catálogo da exibição.
TABLE_SCHEMA	String	Esquema que contém a exibição.
TABLE_NAME	String	Nome da exibição.
CHECK_OPTION	String	Tipo de WITH CHECK OPTION. É CASCADE se a exibição original foi criada usando WITH CHECK OPTION. Caso contrário, será retornado NONE.
IS_UPDATABLE	String	Especifica se a exibição é atualizável. Sempre retorna NO.

ViewColumns

ColumnName	Tipo de dados	Descrição
VIEW_CATALOG	String	Catálogo da exibição.
VIEW_SCHEMA	String	Esquema que contém a exibição.
VIEW_NAME	String	Nome da exibição.
TABLE_CATALOG	String	Catálogo da tabela que está associado a esta exibição.
TABLE_SCHEMA	String	Esquema que contém a tabela associada a esta exibição.
TABLE_NAME	String	Nome da tabela associada à exibição. Tabela base.
COLUMN_NAME	String	Nome da coluna.

UserDefinedTypes

ColumnName	Tipo de dados	Descrição
assembly_name	String	O nome do arquivo para o assembly.
udt_name	String	O nome de classe para o assembly.
version_major	Objeto	Número de versão principal.
version_minor	Objeto	Número de versão secundária.
version_build	Objeto	Número de build.
version_revision	Objeto	Número de revisão.
culture_info	Objeto	As informações de cultura associadas a esse UDT.
public_key	Objeto	A chave pública usada por este assembly.
is_fixed_length	Boolean	Especifica se o tamanho do tipo é sempre o mesmo que max_length.
max_length	Int16	Tamanho máximo do tipo em bytes.
Create_Date	DateTime	A data em que o assembly foi criado/registrado.
Permission_set_desc	String	O nome amigável do conjunto de permissões/nível de segurança do assembly.

Compartilhar via