Mapeamento de tipo de dados em conjuntos de linhas e parâmetros

Aplica-se a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsSistema de Plataforma de Análise (PDW)Base de dados SQL no Microsoft Fabric

Baixar driver OLE DB

Em conjuntos de linhas e como valores de parâmetros, o Driver OLE DB para SQL Server representa dados SQL Server utilizando os seguintes tipos de dados definidos pelo OLE DB, reportados nas funções IColumnsInfo::GetColumnInfo e ICommandWithParameters::GetParameterInfo.

O Driver OLE DB para SQL Server suporta conversões de dados solicitadas pelo consumidor, conforme mostrado na ilustração.

Os objetos sql_variant podem armazenar dados de qualquer tipo de dado SQL Server, exceto texto, ntext, imagem, varchar(max), nvarchar(max), varbinary(max), xml, timestamp e tipos de execução da linguagem comum (CLR) do Microsoft .NET Framework definidos pelo utilizador. Uma instância de dados sql_variant também não pode ter sql_variant como seu tipo de dado base subjacente. Por exemplo, a coluna pode conter valores smallint para algumas linhas, valores float para outras linhas e valores char/nchar no restante.

Quando sql_variant dados são obtidos como DBTYPE_VARIANT, são colocados numa estrutura VARIANTE no buffer. Mas os subtipos na estrutura VARIANT podem não corresponder aos subtipos definidos no sql_variant tipo de dato. Os dados sql_variant devem então ser obtidos como DBTYPE_SQLVARIANT para que todos os subtipos coincidam.

DBTYPE_SQLVARIANT Tipo de Dados

Para suportar o tipo de dado sql_variant , o Driver OLE DB para SQL Server expõe um tipo de dado específico do fornecedor chamado DBTYPE_SQLVARIANT. Quando sql_variant dados são recolhidos como DBTYPE_SQLVARIANT, são armazenados numa estrutura SSVARIANT específica para cada fornecedor. A estrutura SSVARIANT contém todos os subtipos que correspondem aos subtipos do sql_variant tipo de dados.

A propriedade da sessão SSPROP_ALLOWNATIVEVARIANT também deve ser definida como TRUE.

Provider-Specific Propriedade SSPROP_ALLOWNATIVEVARIANT

Na obtenção de dados, pode especificar explicitamente que tipo de dado deve ser devolvido para uma coluna ou para um parâmetro. O IColumnsInfo também pode ser usado para obter a informação da coluna e usá-la para fazer a ligação. Quando o IColumnsInfo é usado para obter informação de colunas para fins de ligação, se a propriedade SSPROP_ALLOWNATIVEVARIANT sessão for FALSE (valor padrão), DBTYPE_VARIANT é devolvido para sql_variant colunas. Se SSPROP_ALLOWNATIVEVARIANT propriedade for FALSA, DBTYPE_SQLVARIANT não é suportado. Se SSPROP_ALLOWNATIVEVARIANT propriedade estiver definida como TRUE, o tipo de coluna é devolvido como DBTYPE_SQLVARIANT, caso em que o buffer manterá a estrutura SSVARIANT. Ao obter sql_variant dados como DBTYPE_SQLVARIANT, a propriedade da sessão SSPROP_ALLOWNATIVEVARIANT deve ser definida como TRUE.

SSPROP_ALLOWNATIVEVARIANT propriedade faz parte do conjunto específico de propriedades de DBPROPSET_SQLSERVERSESSION do fornecedor e é uma propriedade de sessão.

DBTYPE_VARIANT aplica-se a todos os outros fornecedores OLE DB.

SSPROP_ALLOWNATIVEVARIANT

SSPROP_ALLOWNATIVEVARIANT é uma propriedade de sessão e faz parte de DBPROPSET_SQLSERVERSESSION conjunto de propriedades.

Ver também

Tipos de Dados (OLE DB)