Propriedades e comportamentos do conjunto de linhas
Aplica-se a: 
SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Analytics Platform System (PDW)
Confira as seguintes propriedades de conjunto de linhas do Driver do OLE DB para SQL Server:
| ID da propriedade | Descrição |
|---|---|
| DBPROP_ABORTPRESERVE | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o comportamento de um conjunto de linhas depois de uma operação de anulação é determinado por esta propriedade. VARIANT_FALSE: o Driver do OLE DB para SQL Server invalida conjuntos de linhas após uma operação de anulação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas a operações IUnknown e à versão de identificadores de linha e de acessador pendentes. VARIANT_TRUE: o Driver do OLE DB para SQL Server mantém um conjunto de linhas válido. |
| DBPROP_ACCESSORDER | L/G: Leitura/gravação Padrão: DBPROPVAL_AO_RANDOM Descrição: Ordem de acesso. A ordem em que as colunas devem ser acessadas no conjunto de linhas. DBPROPVAL_AO_RANDOM: a coluna pode ser acessada em qualquer ordem. DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: as colunas associadas como objetos de armazenamento podem apenas ser acessadas na ordem sequencial determinada pelo ordinal da coluna. DBPROPVAL_AO_SEQUENTIAL: todas as colunas precisam ser acessadas na ordem sequencial determinada pelo ordinal da coluna. |
| DBPROP_APPENDONLY | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | L/G: Somente leitura Padrão: VARIANT_TRUE Descrição: os objetos de armazenamento do Driver do OLE DB para SQL Server bloqueiam o uso de outros métodos de conjunto de linhas. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server dá suporte a indicadores para identificação de linha do conjunto de linhas quando DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS é VARIANT_TRUE. A definição de qualquer uma das propriedades como VARIANT_TRUE não habilita o posicionamento do conjunto de linhas por indicador. Defina DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll como VARIANT_TRUE para criar um conjunto de linhas que dê suporte ao posicionamento do conjunto de linhas por indicador. O Driver do OLE DB para SQL Server usa um cursor do Microsoft SQL Server para dar suporte a um conjunto de linhas que contenha indicadores. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. Observação: A definição dessas propriedades em conflito com outras propriedades de definição de cursor do OLE DB Driver for SQL Server causa um erro. Por exemplo, a definição de DBPROP_BOOKMARKS como VARIANT_TRUE quando DBPROP_OTHERINSERT também é VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas. |
| DBPROP_BOOKMARKSKIPPED | L/G: Somente leitura Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server retorna DB_E_BADBOOKMARK se o consumidor indica um indicador inválido ao posicionar ou pesquisar um conjunto de linhas com indicadores. |
| DBPROP_BOOKMARKTYPE | L/G: Somente leitura Padrão: DBPROPVAL_BMK_NUMERIC Descrição: o Driver do OLE DB para SQL Server implementa somente indicadores numéricos. Um indicador do Driver do OLE DB para SQL Server é um inteiro sem sinal de 32 bits, do tipo DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server dá suporte à busca e rolagem regressiva em conjuntos de linhas não sequenciais. O OLE DB Driver for SQL Server cria um conjunto de linhas com suporte de cursor quando DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS é VARIANT_TRUE. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. |
| DBPROP_CANHOLDROWS | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: por padrão, o Driver do OLE DB para SQL Server retornará DB_E_ROWSNOTRELEASED se o consumidor tentar obter mais linhas para um conjunto de linhas enquanto existem alterações pendentes nas linhas atualmente no conjunto. Este comportamento pode ser modificado. A definição de DBPROP_CANHOLDROWS e DBPROP_IRowsetChange como VARIANT_TRUE implica um conjunto de linhas com indicadores. Se as duas propriedades forem VARIANT_TRUE, a interface IRowsetLocate estará disponível no conjunto de linhas e DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS serão VARIANT_TRUE. Os conjuntos de linhas do Driver do OLE DB para SQL Server que contêm indicadores são compatíveis com os cursores do SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: esta propriedade só poderá ser definida como VARIANT_TRUE se o conjunto de linhas estiver usando um cursor controlado por conjunto de chaves. |
| DBPROP_COLUMNRESTRICT | L/G: Somente leitura Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server define a propriedade como VARIANT_TRUE quando uma coluna em um conjunto de linhas não pode ser alterada pelo consumidor. Outras colunas no conjunto de linhas podem ser atualizáveis e as linhas em si podem ser excluídas. Quando a propriedade é VARIANT_TRUE, o consumidor examina o membro dwFlags da estrutura DBCOLUMNINFO para determinar se o valor de uma coluna individual pode ser gravado ou não. Para colunas modificáveis, dwFlags exibe DBCOLUMNFLAGS_WRITE. |
| DBPROP_COMMANDTIMEOUT | L/G: Leitura/gravação Padrão: 0 Descrição: por padrão, o Driver do OLE DB para SQL Server não atinge o tempo limite no método ICommand::Execute method. |
| DBPROP_COMMITPRESERVE | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o comportamento de um conjunto de linhas depois de uma operação de confirmação é determinado por esta propriedade. VARIANT_TRUE: o Driver do OLE DB para SQL Server mantém um conjunto de linhas válido. VARIANT_FALSE: o Driver do OLE DB para SQL Server invalida conjuntos de linhas após uma operação de confirmação. A funcionalidade do objeto de conjunto de linhas está praticamente perdida. Ela dá suporte apenas a operações IUnknown e à versão de identificadores de linha e de acessador pendentes. |
| DBPROP_DEFERRED | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: em caso de definição como VARIANT_TRUE, o Driver do OLE DB para SQL Server tenta usar um cursor de servidor para o conjunto de linhas. As colunas text, ntext e image não são retornadas do servidor enquanto não são acessadas pelo aplicativo. |
| DBPROP_DELAYSTORAGEOBJECTS | L/G: Somente leitura Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server dá suporte ao modo de atualização imediato em objetos de armazenamento. As alterações feitas a dados em um objeto de fluxo sequencial são imediatamente enviadas para o SQL Server. As modificações são confirmadas com base no modo de transação de conjunto de linhas. |
| DBPROP_HIDDENCOLUMNS | L/G: Somente leitura Padrão: VARIANT_FALSE Descrição: contagem de colunas ocultas Se DBPROP_UNIQUEROWS for VARIANT_TRUE, a propriedade DBPROP_HIDDENCOLUMNS retornará o número de colunas "ocultas" adicionais incluídas pelo provedor para identificar com exclusividade as linhas dentro do conjunto de linhas. Essas colunas são retornadas por IColumnsInfo::GetColumnInfo e IColumnsRowset::GetColumnsRowset. No entanto, elas não são incluídas na contagem de linhas retornadas pelo argumento pcColumns retornado por IColumnsInfo::GetColumnInfo. Para determinar o número total de colunas representadas na estrutura prgInfo retornada por IColumnsInfo::GetColumnInfo, incluindo colunas ocultas, o consumidor adiciona o valor de DBPROP_HIDDENCOLUMNS à contagem de colunas retornadas de IColumnsInfo::GetColumnInfo em pcColumns. Se DBPROP_UNIQUEROWS for VARIANT_FALSE, DBPROP_HIDDENCOLUMNS será zero. |
| DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | L/G: Somente leitura Padrão: VARIANT_TRUE Descrição: o Driver do OLE DB para SQL Server dá suporte a essas interfaces em todos os conjuntos de linhas. |
| DBPROP_IColumnsRowset | L/G: Leitura/gravação Padrão: VARIANT_TRUE Descrição: o Driver do OLE DB para SQL Server dá suporte à interface IColumnsRowset. |
| DBPROP_IConnectionPointContainer | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: IConnectionPointContainer. Se for VARIANT_TRUE, o conjunto de linhas terá suporte para a interface especificada. Se for VARIANT_FALSE, o conjunto de linhas não terá suporte para a interface especificada. Os provedores que têm suporte para a interface devem aceitar a propriedade associada a essa interface com um valor de VARIANT_TRUE. Essas propriedades são usadas para solicitar interfaces por ICommandProperties::SetProperties. |
| DBPROP_IMultipleResults | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server dá suporte à interface IMultipleResults. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server dá suporte às interfaces IRowsetChange e IRowsetUpdate. Um conjunto de linhas criado usando DBPROP_IRowsetChange igual a VARIANT_TRUE exibe comportamentos de modo de atualização imediatos. Quando DBPROP_IRowsetUpdate é VARIANT_TRUE, DBPROP_IRowsetChange também é VARIANT_TRUE. O conjunto de linhas exibe comportamento de modo de atualização com atraso. O Driver do OLE DB para SQL Server usa um cursor do SQL Server para dar suporte a conjuntos de linhas que expõem IRowsetChange ou IRowsetUpdate. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. |
| DBPROP_IRowsetIdentity | L/G: Leitura/gravação Padrão: VARIANT_TRUE Descrição: o Driver do OLE DB para SQL Server dá suporte à interface IRowsetIdentity. Se um conjunto de linhas der suporte para essa interface, qualquer uma das duas alças de linha que represente a mesma linha subjacente sempre refletirá os mesmos dados e estado. Os consumidores podem chamar o método IRowsetIdentity:: IsSameRow para comparar dois identificadores de linha para ver se eles se referem à mesma instância de linha. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server pode expor as interfaces IRowsetLocate e IRowsetScroll. Quando DBPROP_IRowsetLocate é VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS e DBPROP_CANSCROLLBACKWARDS também são VARIANT_TRUE. Quando DBPROP_IRowsetScroll é VARIANT_TRUE, DBPROP_IRowsetLocate também é VARIANT_TRUE e ambas as interfaces estão disponíveis no conjunto de linhas. São exigidos indicadores para qualquer interface. O OLE DB Driver for SQL Server define DBPROP_BOOKMARKS e DBPROP_LITERALBOOKMARKS como VARIANT_TRUE quando o consumidor solicita uma das interfaces. O Driver do OLE DB para SQL Server usa cursores do SQL Server para dar suporte a IRowsetLocate e IRowsetScroll. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. A definição dessas propriedades em conflito com outras propriedades de definição de cursor do OLE DB Driver for SQL Server causa um erro. Por exemplo, a definição de DBPROP_IRowsetScroll como VARIANT_TRUE quando DBPROP_OTHERINSERT também é VARIANT_TRUE gera um erro quando o consumidor tenta abrir um conjunto de linhas. |
| DBPROP_IRowsetResynch | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server expõe a interface IRowsetResynch sob demanda. O Driver do OLE DB para SQL Server pode expor a interface em qualquer conjunto de linhas. |
| DBPROP_ISupportErrorInfo | L/G: Leitura/gravação Padrão: VARIANT_TRUE Descrição: o Driver do OLE DB para SQL Server expõe a interface ISupportErrorInfo em conjuntos de linhas. |
| DBPROP_ILockBytes | Essa interface não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar a propriedade gera um erro. |
| DBPROP_ISequentialStream | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server expõe a interface ISequentialStream para dar suporte a dados de tamanho variável e longo armazenados no SQL Server. |
| DBPROP_IStorage | Essa interface não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar a propriedade gera um erro. |
| DBPROP_IStream | Essa interface não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar a propriedade gera um erro. |
| DBPROP_IMMOBILEROWS | L/G: Leitura/gravação Padrão: VARIANT_TRUE Descrição: a propriedade só é VARIANT_TRUE para cursores de conjunto de chaves do SQL Server e é VARIANT_FALSE para todos os outros cursores. VARIANT_TRUE: o conjunto de linhas não reorganizará as linhas inseridas ou atualizadas. Para IRowsetChange::InsertRow, as linhas serão exibidas no fim do conjunto de linhas. Para IRowsetChange::SetData, se o conjunto de linhas não estiver ordenado, a posição das linhas atualizadas não será alterada. Se o conjunto de linhas for ordenado e IRowsetChange::SetData alterar uma coluna que é usada para ordenar o conjunto de linhas, a linha não será movida. Se o conjunto de linhas for criado em um conjunto de colunas de chave (geralmente, um conjunto de linhas para o qual DBPROP_OTHERUPDATEDELETE é VARIANT_TRUE, mas DBPROP_OTHERINSERT é VARIANT_FALSE), a alteração do valor de uma coluna de chave será geralmente equivalente à exclusão da linha atual e à inserção de uma nova linha. Portanto, a linha poderá parecer mover ou até mesmo desaparecer do conjunto de linhas, se DBPROP_OWNINSERT for VARIANT_FALSE, embora a propriedade DBPROP_IMMOBILEROWS seja VARIANT_TRUE. VARIANT_FALSE: se o conjunto de linhas for ordenado, as linhas inseridas serão exibidas na ordem correta do conjunto de linhas. Se o conjunto de linhas não for ordenado, a linha inserida aparecerá no final. Se IRowsetChange::SetData alterar uma coluna que é usada para ordenar o conjunto de linhas, a linha será movida. Se o conjunto de linhas não for ordenado, a posição da linha não será alterada. |
| DBPROP_LITERALIDENTITY | L/G: Somente leitura Padrão: VARIANT_TRUE Descrição: essa propriedade é sempre VARIANT_TRUE. |
| DBPROP_LOCKMODE | L/G: Leitura/gravação Padrão: DBPROPVAL_LM_NONE Descrição: nível de bloqueio executado pelo conjunto de linhas (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW). Observação: ao usar o isolamento do instantâneo em uma transação, se um conjunto de linhas for aberto usando um conjunto de chaves ou um cursor de servidor dinâmico e o modo de bloqueio estiver definido como DBPROPVAL_LM_SINGLEROW, ocorrerá um erro durante o fetch de uma linha se outro usuário tiver atualizado essa linha desde o início da transação. Para outros tipos de cursor e modos de bloqueio, se algum outro usuário tiver atualizado a linha desde o início da transação, não ocorrerá um erro até o usuário tentar atualizar a linha. Em ambos os casos, esses erros são gerados pelo servidor. |
| DBPROP_MAXOPENROWS | L/G: Somente leitura Padrão: 0 Descrição: o Driver do OLE DB para SQL Server não limita o número de linhas que podem estar ativas em conjuntos de linhas. |
| DBPROP_MAXPENDINGROWS | L/G: Somente leitura Padrão: 0 Descrição: o Driver do OLE DB para SQL Server não limita o número de linhas de conjuntos de linhas com alterações pendentes. |
| DBPROP_MAXROWS | L/G: Leitura/gravação Padrão: 0 Descrição: por padrão, o Driver do OLE DB para SQL Server não limita o número de linhas em um conjunto de linhas. Quando o consumidor define DBPROP_MAXROWS, o OLE DB Driver for SQL Server usa a instrução SET ROWCOUNT para limitar o número de linhas no conjunto de linhas. SET ROWCOUNT pode causar consequências não intencionais na execução de instrução do SQL Server. Para obter mais informações, confira SET ROWCOUNT. |
| DBPROP_MAYWRITECOLUMN | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_MEMORYUSAGE | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_NOTIFICATIONGRANULARITY | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_NOTIFICATIONPHASES | L/G: Somente leitura Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Descrição: o Driver do OLE DB para SQL Server dá suporte a todas as fases de notificação. |
| DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE | L/G: Somente leitura Padrão: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Descrição: as fases de notificação do Driver do OLE DB para SQL Server podem ser canceladas antes de uma tentativa de executar a modificação do conjunto de linhas indicada. O Driver do OLE DB para SQL Server não dá suporte ao cancelamento de fase após a conclusão da tentativa. |
| DBPROP_ORDEREDBOOKMARKS | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: a configuração de propriedades de visibilidade de alterações faz com que o Driver do OLE DB para SQL Server use cursores do SQL Server para dar suporte ao conjunto de linhas. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. |
| DBPROP_QUICKRESTART | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: em caso de definição como VARIANT_TRUE, o Driver do OLE DB para SQL Server tenta usar um cursor de servidor para o conjunto de linhas. |
| DBPROP_REENTRANTEVENTS | L/G: Somente leitura Padrão: VARIANT_TRUE Descrição: os conjuntos de linhas do Driver do OLE DB para SQL Server são reentrantes e podem retornar DB_E_NOTREENTRANT se um consumidor tenta acessar um método de conjunto de linhas não reentrante em um retorno de chamada de notificação. |
| DBPROP_REMOVEDELETED | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server altera o valor da propriedade com base na visibilidade de alterações feitas nos dados do SQL Server expostos pelo conjunto de linhas. VARIANT_TRUE: as linhas excluídas pelo consumidor ou outros usuários do SQL Server são removidos do conjunto de linhas quando o conjunto de linhas é atualizado. DBPROP_OTHERINSERT é VARIANT_TRUE. VARIANT_FALSE: as linhas excluídas pelo consumidor ou outros usuários do SQL Server não são removidos do conjunto de linhas quando o conjunto de linhas é atualizado. O valor de status de linha para linhas excluídas do SQL Server no conjunto de linhas é DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT é VARIANT_TRUE. Esta propriedade só tem valor para conjuntos de linhas com suporte de cursores do SQL Server. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. Quando a propriedade DBPROP_REMOVEDELETED é implementada em um conjunto de linhas de cursor do conjunto de chaves, as linhas excluídas são removidas no momento do fetch e é possível para os métodos de fetch de linhas, como GetNextRows e GetRowsAt, retornar S_OK e menos linhas do que solicitado. Observe que este comportamento não significa que a condição DB_S_ENDOFROWSET e que o número de linhas retornadas nunca serão zero se houver alguma linha restante. |
| DBPROP_REPORTMULTIPLECHANGES | Esta propriedade de conjunto de linhas não é implementada pelo Driver do OLE DB para SQL Server. A tentativa de ler ou gravar o valor da propriedade gera um erro. |
| DBPROP_RETURNPENDINGINSERTS | L/G: Somente leitura Padrão: VARIANT_FALSE Descrição: quando um método que busca linhas é chamado, o Driver do OLE DB para SQL Server não retorna linhas de inserção pendentes. |
| DBPROP_ROWRESTRICT | L/G: Somente leitura Padrão: VARIANT_TRUE Descrição: os conjuntos de linhas do Driver do OLE DB para SQL Server não dão suporte a direitos de acesso com base na linha. Se a interface IRowsetChange for exposta em um conjunto de linhas, o método SetData poderá ser chamado pelo consumidor. |
| DBPROP_ROWSET_ASYNCH | L/G: Leitura/gravação Padrão: 0 Descrição: fornece processamento assíncrono de conjunto de linhas. Esta propriedade está no grupo de propriedades Conjunto de linhas e no conjunto de propriedades DBPROPSET_ROWSET. Tipo é VT_14. O único valor na bitmask compatível com o Driver do OLE DB para SQL Server é DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | L/G: Somente leitura Padrão: DBPROPVAL_RT_FREETHREAD Descrição: o Driver do OLE DB para SQL Server dá suporte ao acesso a seus objetos em vários threads de execução de um só consumidor. |
| DBPROP_SERVERCURSOR | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: em caso de uma definição, um cursor do SQL Server é usado para dar suporte ao conjunto de linhas. Para obter mais informações, confira Conjuntos de linha e cursores do SQL Server. |
| DBPROP_SERVERDATAONINSERT | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: dados de servidor na inserção. VARIANT_TRUE: no momento em que uma inserção é transmitida ao servidor, o provedor recupera dados do servidor para atualizar o cache de linha local. VARIANT_FALSE: o provedor não recupera valores de servidor para linhas recentemente inseridas. |
| DBPROP_STRONGIDENTITY | L/G: Somente leitura Padrão: VARIANT_TRUE Descrição: identidade de linha forte. Se forem permitidas inserções em um conjunto de linhas (IRowsetChange ou IRowsetUpdate for verdadeiro) e DBPROP_UPDATABILITY for definido para dar suporte a InsertRows, o valor de DBPROP_STRONGIDENTITY dependerá da propriedade DBPROP_CHANGEINSERTEDROWS (será VARIANT_FALSE se o valor da propriedade DBPROP_CHANGEINSERTEDROWS for VARIANT_FALSE). |
| DBPROP_TRANSACTEDOBJECT | L/G: Somente leitura Padrão: VARIANT_FALSE Descrição: o Driver do OLE DB para SQL Server dá suporte apenas a objetos transacionados. Para obter mais informações, veja Transações. |
| DBPROP_UNIQUEROWS | L/G: Leitura/gravação Padrão: VARIANT_FALSE Descrição: Linhas exclusivas. VARIANT_TRUE: cada linha é identificada exclusivamente por seus valores de coluna. O conjunto de colunas que identificam exclusivamente a linha tem a propriedade DBCOLUMNFLAGS_KEYCOLUMN definida na estrutura DBCOLUMNINFO retornada do método GetColumnInfo. VARIANT_FALSE: as linhas podem ou não ser identificadas exclusivamente pelos respectivos valores de coluna. As colunas de chave podem ou não ser sinalizadas com DBCOLUMNFLAGS_KEYCOLUMN. |
| DBPROP_UPDATABILITY | L/G: Leitura/gravação Padrão: 0 Descrição: o Driver do OLE DB para SQL Server dá suporte a todos os valores de DBPROP_UPDATABILITY. A definição de DBPROP_UPDATABILITY não cria um conjunto de linhas modificável. Para tornar um conjunto de linhas modificável, defina DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate. |
O OLE DB Driver for SQL Server define o conjunto de propriedades específico do provedor, DBPROPSET_SQLSERVERROWSET, conforme mostrado nesta tabela.
| ID da propriedade | Descrição |
|---|---|
| SSPROP_COLUMN_ID | Coluna: ColumnID L/G: Somente leitura Tipo: VT_U12 | VT_ARRAY Padrão: VT_EMPTY Descrição: uma matriz de valores de número inteiro que representam a posição ordinal (de base 1) de uma coluna de resultados da cláusula COMPUTE dentro da instrução Transact-SQL SELECT atual. Este é o Driver do OLE DB para SQL Server equivalente do atributo SQL_CA_SS_COLUMN_ID do ODBC. |
| SSPROP_DEFERPREPARE | Coluna: Não L/G: Leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_TRUE Descrição: VARIANT_TRUE: na execução preparada, a preparação de comando é adiada até que ICommand::Execute é chamada ou uma operação de metapropriedade é executada. Se a propriedade for definida como VARIANT_FALSE: a instrução é preparada quando ICommandPrepare::Prepare é executada. |
| SSPROP_IRowsetFastLoad | Coluna: Não L/G: Leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: defina essa propriedade como VARIANT_TRUE para abrir um conjunto de linhas de carga rápida por meio de IOpenRowset::OpenRowset. Não é possível definir essa propriedade em ICommandProperties::SetProperties. |
| SSPROP_ISSAsynchStatus | Coluna: Não. L/G: Leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: defina essa propriedade como VARIANT_TRUE para habilitar operações assíncronas que usam a interface ISSAsynchStatus. |
| SSPROP_ISSDataClassification | L/G: Leitura/gravação Tipo: VT_BOOL Padrão: VARIANT_TRUE Descrição: O Driver OLE DB para SQL Server dá suporte à recuperação de informações de classificação de confidencialidade usando a interface ISSDataClassification. |
| SSPROP_MAXBLOBLENGTH | Coluna: Não L/G: Leitura/gravação Tipo: VT_I4 Padrão: o provedor não restringe o tamanho do texto retornado pelo servidor e o valor da propriedade é definido como seu máximo. Por exemplo, 2147483647. Descrição: o Driver do OLE DB para SQL Server executa uma instrução SET TEXTSIZE para restringir o tamanho dos dados BLOB (objeto binário grande) retornados em uma instrução SELECT. |
| SSPROP_NOCOUNT_STATUS | Coluna: NoCount L/G: Somente leitura Tipo: VT_BOOL Padrão: VARIANT_FALSE Descrição: um valor booliano que representa o status de SET NOCOUNT ON/OFF no SQL Server: VARIANT_TRUE: quando SET NOCOUNT ON VARIANT_FALSE: quando SET NOCOUNT OFF |
| SSPROP_QP_NOTIFICATION_MSGTEXT | Coluna: Não L/G: Leitura/gravação Tipo: VT_BSTR (1 a 2.000 caracteres permitidos) Padrão: cadeia de caracteres vazia Descrição: o texto de mensagem da notificação de consulta. Esta propriedade é definida pelo usuário e não tem nenhum formato definido. |
| SSPROP_QP_NOTIFICATION_OPTIONS | Coluna: Não L/G: Leitura/gravação Tipo: VT_BSTR Padrão: cadeia de caracteres vazia Descrição: As opções de notificação de consulta. Essas opções são especificadas em uma cadeia de caracteres com name=value. O usuário é responsável por criar o serviço e ler as notificações da fila. A sintaxe da cadeia de caracteres das opções de notificação de consulta é:service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]Por exemplo: service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Coluna: Não L/G: Leitura/gravação Tipo: VT_UI4 Padrão: 432.000 segundos (5 dias) Mínimo: 1 segundo Máximo: 2^31-1 segundos Descrição: O número de segundos que a notificação de consulta permanece ativa. |