Visão geral do Provedor Microsoft OLE DB para SQL Server

O Provedor Microsoft OLE DB para SQL Server, o SQLOLEDB, permite que o ADO acesse o Microsoft SQL Server.

Parâmetros de cadeia de conexão

Para se conectar a esse provedor, defina o argumento Provider para a propriedade ConnectionString como:

SQLOLEDB

Esse valor também pode ser definido ou lido por meio da propriedade Provider.

Cadeia de conexão típica

Uma cadeia de conexão típica para esse provedor é:

"Provider=SQLOLEDB;Data Source=serverName;"
Initial Catalog=databaseName;
User ID=MyUserID;Password=<password>;"

A cadeia de caracteres consiste nestas palavras-chave:

Parâmetros de conexão específicos do provedor

O provedor dá suporte a vários parâmetros de conexão específicos do provedor, além daqueles definidos pelo ADO. Assim como acontece com as propriedades de conexão do ADO, essas propriedades específicas do provedor podem ser definidas por meio da coleção Properties de uma Properties ou podem ser definidas como parte da ConnectionString.

Uso do objeto Command

O SQLOLEDB aceita uma mistura de ODBC, ANSI e Transact-SQL específico do SQL Server como uma sintaxe válida. Por exemplo, a seguinte instrução SQL usa uma sequência de escape do ODBC SQL para especificar a função de cadeia de caracteres LCASE:

SELECT customerid={fn LCASE(CustomerID)} FROM Customers

LCASE retorna uma cadeia de caracteres, convertendo todos os caracteres em maiúscula aos seus equivalentes em minúsculas. A função de cadeia de caracteres LOWER ANSI SQL executa a mesma operação, ou seja, a seguinte instrução SQL é uma equivalente ANSI da instrução ODBC apresentada anteriormente:

SELECT customerid=LOWER(CustomerID) FROM Customers

O SQLOLEDB processa com sucesso qualquer forma da instrução quando especificado como texto para um comando.

Procedimentos armazenados

Ao executar um procedimento armazenado do SQL Server usando um comando do SQLOLEDB, use a sequência de escape da chamada de procedimento do ODBC no texto do comando. Em seguida, o SQLOLEDB usa o mecanismo de chamada de procedimento remoto do SQL Server para otimizar o processamento do comando. Por exemplo, a seguinte instrução SQL do ODBC é o texto de comando preferível ao formato do Transact-SQL:

ODBC SQL

{call SalesByCategory('Produce', '1995')}

Transact-SQL

EXECUTE SalesByCategory 'Produce', '1995'

Recursos do SQL Server

Com o SQL Server, o ADO pode usar o XML para a entrada de Command e recuperar os resultados no formato do fluxo XML em vez de em objetos Recordset. Para obter mais informações, confira Como usar fluxos para a entrada de comando e Como recuperar os conjuntos de resultados em fluxos.

Como acessar os dados do sql_variant usando o MDAC 2.7, o MDAC 2.8 ou o Windows DAC 6.0

O Microsoft SQL Server tem um tipo de dados chamado sql_variant. Semelhante ao DBTYPE_VARIANT do OLE DB, o tipo de dados sql_variant pode armazenar dados de vários tipos diferentes. No entanto, há algumas diferenças importantes entre o DBTYPE_VARIANT e o sql_variant. O ADO também lida com os dados armazenados como um valor sql_variant diferente de como ele lida com outros tipos de dados. A lista a seguir descreve os problemas a serem considerados quando você acessa os dados do SQL Server armazenados em colunas do tipo sql_variant.

• No MDAC 2.7, no MDAC 2.8 e no Windows DAC (Windows Data Access Components) 6.0, o Provedor OLE DB para SQL Server dá suporte ao tipo sql_variant. Isso não ocorre com o Provedor OLE DB para ODBC.

• O tipo sql_variant não corresponde exatamente ao tipo de dados DBTYPE_VARIANT. O tipo sql_variant dá suporte a alguns novos subtipos não compatíveis com DBTYPE_VARIANT, incluindo cadeias de caracteres GUID, ANSI (não UNICODE) e BIGINT. O uso de subtipos diferentes daqueles já listados funcionará corretamente.

• O subtipo sql_variant NUMERIC não corresponde ao DBTYPE_DECIMAL em tamanho.

• Várias coerções de tipo de dados resultarão em tipos não correspondentes. Por exemplo, a coerção de um sql_variant com um subtipo de GUID em um DBTYPE_VARIANT resultará em um subtipo de safearray (bytes). A conversão desse tipo novamente em um sql_variant resultará em um novo subtipo de array (bytes).

• Os campos Recordset que contêm dados sql_variant podem ser acessados remotamente (com marshaling) ou persistidos somente se o sql_variant contém subtipos específicos. A tentativa de acessar remotamente ou persistir dados com os seguintes subtipos sem suporte causará um erro em tempo de execução (conversão sem suporte) do MSPersist (Provedor de Persistência da Microsoft): VT_VARIANT, VT_RECORD, VT_ILLEGAL, VT_UNKNOWN, VT_BSTR e VT_DISPATCH.

• O Provedor OLE DB para SQL Server no MDAC 2.7, no MDAC 2.8 e no Windows DAC 6.0 tem uma propriedade dinâmica chamada Allow Native Variants que, como o nome indica, permite que os desenvolvedores acessem o sql_variant na forma nativa em vez de um DBTYPE_VARIANT. Se essa propriedade estiver definida e um Recordset for aberto com o Mecanismo de Cursor do Cliente (adUseClient), a chamada a Recordset.Open falhará. Se essa propriedade estiver definida e um Recordset for aberto com cursores de servidor (adUseServer), a chamada a Recordset.Open terá sucesso, mas o acesso às colunas do tipo sql_variant produzirá um erro.

• Em aplicativos cliente que usam o MDAC 2.5, os dados sql_variant podem ser usados com as consultas no Microsoft SQL Server. No entanto, os valores dos dados sql_variant são tratados como cadeias de caracteres. Esses aplicativos cliente devem ser atualizados para o MDAC 2.7, o MDAC 2.8 ou o Windows DAC 6.0.

Comportamento do Recordset

O SQLOLEDB não pode usar os cursores do SQL Server para dar suporte aos resultados múltiplos gerados por muitos comandos. Se um consumidor solicitar um conjunto de registros que exija o suporte de cursor do SQL Server, ocorrerá um erro se o texto do comando usado gerar mais de um só conjunto de registros como resultado.

Há suporte para conjuntos de registros SQLOLEDB roláveis nos cursores do SQL Server. O SQL Server indica limitações sobre cursores que são sensíveis às alterações feitas por outros usuários do banco de dados. Especificamente, as linhas em alguns cursores não podem ser ordenadas e a tentativa de criar um conjunto de registros usando um comando que contém uma cláusula SQL ORDER BY pode falhar.

Propriedades Dinâmicas

O Provedor Microsoft OLE DB para SQL Server insere várias propriedades dinâmicas na coleção Properties dos objetos Connection, Recordset e Command não abertos.

As tabelas a seguir são um índice cruzado dos nomes ADO e OLE DB para cada propriedade dinâmica. A Referência do Programador do OLE DB refere-se a um nome de propriedade ADO pelo termo "Descrição". Encontre mais informações sobre essas propriedades na Referência do Programador do OLE DB. Procure o nome da propriedade OLE DB no Índice ou confira Apêndice C: Propriedades do OLE DB.

Propriedades dinâmicas de conexão

As propriedades a seguir são adicionadas à coleção Properties do objeto Connection.

Propriedades dinâmicas do conjunto de registros

As propriedades a seguir são adicionadas à coleção Properties do objeto Recordset.

Propriedades dinâmicas de Command

As propriedades a seguir são adicionadas à coleção Properties do objeto Command.

Para obter detalhes específicos da implementação e informações funcionais sobre o Provedor OLE DB do Microsoft SQL Server, confira o Provedor do SQL Server.

Confira também

Propriedade ConnectionString (ADO)Propriedade Provider (ADO)Objeto Recordset (ADO)