Compartilhar via


Propriedades XMLA suportadas (XMLA)

O Microsoft SQL Server Analysis Services oferece suporte às propriedades listadas na tabela a seguir. Você usa estas propriedades listadas no elemento Properties dos métodos Identify e Execute.

Nome

Elemento

AxisFormat

Uso

Propriedade String opcional, somente gravação

Descrição

Determina o formato usado dentro de um conjunto de resultados MDDataSet para descrever os eixos do conjunto de dados multidimensional. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
ClusterFormat O eixo MDDataSet é feito para cima de um ou mais elementos CrossProduct.
CustomFormat Analysis Services usa o formato TupleFormat para esta configuração.
TupleFormat (Padrão) O eixo MDDataSet contém um ou mais elementos Tuple.

Esta propriedade pode ser usada com o método Execute.

BeginRange

Uso

Propriedade Integer opcional, somente gravação

Descrição

Contém um valor inteiro baseado em zero que corresponde a um valor de atributo CellOrdinal. (O atributo CellOrdinal faz parte do elemento Cell na seção CellDataMDDataSet.)

Usada junto com a propriedade EndRange, o aplicativo cliente pode usar essa propriedade a limitar um conjunto de dados OLAP retornado por um comando a um intervalo de células específico. Se –1 for especificado, serão retornadas todas as células até a célula especificada na propriedade EndRange.

O valor padrão para essa propriedade é -1.

Esta propriedade pode ser usada com o método Execute.

Catálogo

Uso

Propriedade String opcional, leitura/gravação

Descrição

Ao estabelecer uma sessão com uma instância do Analysis Services para enviar um comando XMLA, essa propriedade é equivalente à propriedade OLE DB DBPROP_INIT_CATALOG.

Quando você define essa propriedade durante uma sessão para alterar o banco de dados atual da sessão, essa propriedade é equivalente à propriedade OLE DB DBPROP_CURRENTCATALOG.

O valor padrão desta propriedade é uma cadeia de caracteres vazia.

Esta propriedade pode ser usada com os métodos Discover e Execute.

CatalogLocation

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_CATALOGLOCATION.

O valor padrão desta propriedade é zero (0), equivalente a DBPROPVAL_CL_START.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ClientProcessID

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Contém o identificador (ID) do thread de processo da sessão atual.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

CommitTimeout

Uso

Propriedade Integer opcional, somente gravação

Descrição

Determina quanto tempo, em segundos, a fase de confirmação de um XMLA comando que está sendo executado no momento espera antes da reversão. A fase de confirmação corresponde a comandos XMLA como Statement ou Process.

Um valor de zero (0) indica que a instância espera indefinidamente.

O valor padrão dessa propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

Conteúdo

Uso

Propriedade String opcional, somente gravação

Descrição

Determina o tipo de dados retornado dos métodos Discover e Execute. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
None Permite verificar a estrutura do comando, mas não a execução.
Schema Retorna o esquema XML relacionado ao comando solicitado. O esquema de XML indica colunas e outras informações.
Data Retorna somente os dados solicitados.
SchemaData (Padrão) Retorna a informações de esquema e os dados.

Esta propriedade pode ser usada com os métodos Discover e Execute.

Cubo

Uso

Propriedade String opcional, somente gravação

Descrição

Contém o nome do cubo que define o contexto do comando. Se o próprio comando contém um nome de cubo, por exemplo, na cláusula FROM de uma instrução SELECT da linguagem MDX, a configuração dessa propriedade é ignorada.

O valor padrão desta propriedade é uma cadeia de caracteres vazia.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DataSourceInfo

Uso

Propriedade String necessária, de leitura/gravação

Descrição

Contém as informações necessárias para estabelecer uma conexão à fonte de dados, por exemplo, o nome de instância.

Aplicativos clientes não devem construir o conteúdo da propriedade DataSourceInfo para enviar a uma instância. Em vez disso, o aplicativo cliente deve localizar as fontes de dados suportadas pelo provedor, usando o método Discover para recuperar o conjunto de linhas DISCOVER_DATASOURCES. O aplicativo cliente envia o mesmo valor da propriedade DataSourceInfo que o cliente recuperou do conjunto de linhas DISCOVER_DATASOURCES.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropCatalogTerm

Uso

Propriedade String opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_CATALOGTERM.

O valor padrão para esta propriedade é "Database".

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropCatalogUsage

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_CATALOGUSAGE.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropColumnDefinition

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_COLUMNDEFINITION.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropConcatNullBehavior

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_CONCATNULLBEHAVIOR.

O valor padrão para esta propriedade é 1, equivalente a DBPROPVAL_CB_NULL.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropDataSourceReadOnly

Uso

Propriedade Boolean opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_DATASOURCEREADONLY.

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropGroupBy

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_GROUPBY.

O valor padrão para esta propriedade é 2, equivalente a DBPROPVAL_GB_EQUALS_SELECT.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropHeterogeneousTables

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_HETEROGENEOUSTABLES.

O valor padrão dessa propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropIdentifierCase

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_IDENTIFIERCASE.

O valor padrão para esta propriedade é 8, equivalente a DBPROPVAL_IC_MIXED.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropInitMode

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_INIT_MODE.

Os únicos valores com suporte para esta propriedade são DB_MODE_READWRITE e DB_MODE_READ.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMaxIndexSize

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MAXINDEXSIZE.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMaxOpenChapters

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MAXOPENCHAPTERS.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMaxRowSize

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MAXROWSIZE.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMaxRowSizeIncludeBlob

Uso

Propriedade Boolean opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MAXROWSIZEINCLUDESBLOB.

O valor padrão desta propriedade é TRUE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMaxTablesInSelect

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MAXTABLESINSELECT.

O valor padrão para essa propriedade é 1.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdAutoexists

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Determina o comportamento de autoexists. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
0 Valor padrão, igual a 1.
1 Aplique deep autoexists a eixos de consulta e conjuntos nomeados. Inclui cláusulas e subseleções WHERE.
2 Aplique deep autoexists a eixos de consulta e exclua conjuntos nomeados de autoexists. Inclui cláusulas e subseleções WHERE.
3 Não aplique nenhum autoexists a conjuntos nomeados com a cláusula WHERE. Aplique shallow autoexists a eixos de consulta com a cláusula WHERE. Aplique deep autoexists a eixos de consulta e conjuntos nomeados com subseleções.

Zero ou vazio são os valores padrão dessa propriedade.

Esta é uma propriedade de sessão que só pode ser definida quando a sessão é criada.

DbpropMsmdCacheMode

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdCachePolicy

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdCacheRatio

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdCacheRatio2

Uso

Propriedade Double opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdCompareCaseNotSensitiveStringFlags

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Determina comparação de cadeia de caracteres com diferenciação entre maiúsculas e minúsculas e funcionalidade de ordem de classificação. Esta propriedade controla a forma como as comparações são feitas nos conjuntos de caracteres que não oferecem suporte a caracteres maiúsculos e minúsculos, como, por exemplo, katakana para japonês e Hindi. O valor desta propriedade é definido na primeira conexão do thread de processo e afeta todas as conexões subsequentes nesse thread de processo.

Use a tabela a seguir para determinar quais sinalizadores devem ser usados.

NomeValorDescrição
NORM_IGNORECASE 0x00000001 A diferenciação entre maiúsculas e minúsculas é ignorada.
Não se aplica 0x00000002 Comparação binária. Os caracteres são comparados com base no valor subjacente no conjunto de caracteres, não na ordem do alfabeto específico.
NORM_IGNORENONSPACE 0x00000010 São ignorados caracteres sem-espaçamento.
NORM_IGNORESYMBOLS 0x00000100 São ignorados símbolos.
NORM_IGNOREKANATYPE 0x00001000 Nenhuma diferenciação é feita entre os caracteres hiragana e katakana. Quando comparados, caracteres hiragana e katakana correspondentes são considerados iguais.
NORM_IGNOREWIDTH 0x00010000 Nenhuma diferenciação é feita entre as versões de um único byte e de dois bytes do mesmo caractere.
SORT_STRINGSORT 0x00100000 A pontuação é tratada da mesma forma que os símbolos.

Para obter mais informações sobre a comparação de cadeias de caracteres no OLE DB, pesquise "CompareString" na seção Platform SDK da Biblioteca MSDN.

Esta propriedade não tem um valor padrão.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdCompareCaseSensitiveStringFlags

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Determina comparação de cadeia de caracteres sem diferenciação entre maiúsculas e minúsculas e funcionalidade de ordem de classificação. Esta propriedade controla a forma como as comparações são feitas nos conjuntos de caracteres que não oferecem suporte a caracteres maiúsculos e minúsculos, como, por exemplo, katakana para japonês e Hindi. O valor desta propriedade é definido na primeira conexão do thread de processo e afeta todas as conexões subsequentes nesse thread de processo.

Use a tabela a seguir para determinar quais sinalizadores devem ser usados.

NomeValorDescrição
NORM_IGNORECASE 0x00000001 A diferenciação entre maiúsculas e minúsculas é ignorada.
Não se aplica 0x00000002 Comparação binária. Os caracteres são comparados com base no valor subjacente no conjunto de caracteres, não na ordem do alfabeto específico.
NORM_IGNORENONSPACE 0x00000010 São ignorados caracteres sem-espaçamento.
NORM_IGNORESYMBOLS 0x00000100 São ignorados símbolos.
NORM_IGNOREKANATYPE 0x00001000 Nenhuma diferenciação é feita entre os caracteres hiragana e katakana. Quando comparados, caracteres hiragana e katakana correspondentes são considerados iguais.
NORM_IGNOREWIDTH 0x00010000 Nenhuma diferenciação é feita entre as versões de um único byte e de dois bytes do mesmo caractere.
SORT_STRINGSORT 0x00100000 A pontuação é tratada da mesma forma que os símbolos.

Para obter mais informações sobre a comparação de cadeias de caracteres no OLE DB, pesquise "CompareString" na seção Platform SDK da Biblioteca MSDN.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdDebugMode

Uso

Propriedade String opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdDynamicDebugLimit

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdFlattened2

Uso

Propriedade Boolean opcional, leitura/gravação

Descrição

Executa saídas de todos os membros como uma hierarquia pai-filho em uma única coluna da tabela no resultado simplificado, exceto se a hierarquia pai-filho for solicitada no Eixo 0. O modelo Nível para colunas de saída não é usado.

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdMDXCompatibility

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Determina como são tratados membros de espaços reservados em uma hierarquia imperfeita ou desbalanceada. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
0 Para compatibilidade com versões anteriores de Analysis Services, este valor é equivalente a 1
1 Hierarquias em dimensões com função múltipla recebem uma legenda que inclui o nome da dimensão e o nome de hierarquia. A legenda tem o seguinte formato: [Dimension].[Hierarchy] Membros de espaço reservado são expostos.
2 Hierarquias em dimensões com função múltipla recebem uma legenda que inclui o nome da dimensão e o nome de hierarquia. A legenda tem o seguinte formato: [Dimension].[Hierarchy] Membros de espaço reservado não são expostos.
3 (Padrão) Membros de espaço reservado não são expostos.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdMDXUniqueNameStyle

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Determina o algoritmo para a geração dos nomes exclusivos de membros em uma dimensão. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
0 Para compatibilidade com versões anteriores de Analysis Services, este valor é equivalente a 2.
1 Usa um algoritmo de caminho de chaves: [dim].&[key1].&[key2]
2 Usa um algoritmo de caminho de nomes: [dim].[name1].&[name2]
3 Usa nomes exclusivos garantidos que são estáveis com o passar do tempo.

O valor padrão para essa propriedade é 6.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdSQLCompatibility

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMsmdSubQueries

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Uma máscara de bits que determina o comportamento das subconsultas. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
0 Valor padrão, Compatível com versões anteriores do Analysis Services. Membros ou conjuntos calculados não são permitidos em subseleções ou subcubos.
1 Membros ou conjuntos calculados são permitidos em subseleções ou subcubos. Não são incluídos ascendentes do membro calculado no espaço da subseleção ou subcubo.
2 Membros ou conjuntos calculados são permitidos em subseleções ou subcubos. São incluídos ascendentes do membro calculado no espaço da subseleção ou subcubo.

Zero ou vazio são os valores padrão dessa propriedade.

Esta é uma propriedade de sessão que só pode ser definida quando a sessão é criada.

Consulte Membros calculados em subseleções e subcubos para obter uma explicação detalhada do comportamento de membros ou conjuntos calculados em subseleções e subcubos.

DbpropMsmdUseFormulaCache

Uso

Propriedade String opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropMultiTableUpdate

Uso

Propriedade Boolean opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MULTITABLEUPDATE.

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropNullCollation

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_NULLCOLLATION.

O valor padrão desta propriedade é 4, equivalente a DBPROPVAL_NC_LOW.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropOrderByColumnsInSelect

Uso

Propriedade Boolean opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_ORDERBYCOLUMNSINSELECT.

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropOutputParameterAvailable

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_OUTPUTPARAMETERAVAILABILITY.

O valor padrão desta propriedade é 1, equivalente a DBPROPVAL_OA_NOTSUPPORTED.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropPersistentIdType

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_PERSISTENTIDTYPE.

O valor padrão desta propriedade é 4, equivalente a DBPROPVAL_PT_NAME.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropPrepareAbortBehavior

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_PREPAREABORTBEHAVIOR.

O valor padrão desta propriedade é 1, equivalente a DBPROPVAL_CB_DELETE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropPrepareCommitBehavior

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_PREPARECOMMITBEHAVIOR.

O valor padrão desta propriedade é 1, equivalente a DBPROPVAL_CB_DELETE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropProcedureTerm

Uso

Propriedade String opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_PROCEDURETERM.

O valor padrão desta propriedade é "Membro calculado".

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropQuotedIdentifierCase

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_QUOTEDIDENTIFIERCASE.

O valor padrão para esta propriedade é 8, equivalente a DBPROPVAL_IC_MIXED.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropSchemaUsage

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_SCHEMAUSAGE.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropSqlSupport

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_SQLSUPPORT.

O valor padrão desta propriedade é 512, equivalente a DBPROPVAL_SQL_SUBMINIMUM.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropSubqueries

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_SUBQUERIES.

ObservaçãoObservação
Embora Data Mining Extensions (DMX) aceite subconsultas, esta propriedade refere-se a suporte de subconsultas em SQL.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropSupportedTxnDdl

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_SUPPORTEDTXNDDL.

O valor padrão desta propriedade é zero (0), equivalente a DBPROPVAL_TC_NONE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropSupportedTxnIsoLevels

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_SUPPORTEDTXNISOLEVELS.

O valor padrão desta propriedade é 4096, equivalente a DBPROPVAL_TI_READCOMMITTED.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropSupportedTxnIsoRetain

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_SUPPORTEDTXNISORETAIN.

O valor padrão desta propriedade é 292, equivalente a uma combinação de DBPROPVAL_TR_ABORT_NO, DBPROPVAL_TR_COMMIT_NO e DBPROPVAL_TR_NONE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

DbpropTableTerm

Uso

Propriedade String opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_TABLETERM.

O valor padrão para essa propriedade é "Cubo".

Esta propriedade pode ser usada com os métodos Discover e Execute.

Dialect

Uso

Propriedade String opcional, leitura/gravação

Descrição

Estabelece o dialeto usado nas seguintes situações:

  • O dialeto que o provedor usará na primeira vez que tentar executar uma consulta.

  • O dialeto usado para os erros de execução retornados como o resultado de falhas de consulta.

Os dialetos disponíveis para esta propriedade estão listados na tabela a seguir.

NomeValorDescrição
DBGUID_SQL C8B522D7-5CF3-11CE-ADE5-00AA0044773D O analisador de SQL tem precedência.
MDGUID_DM 62C58FED-CCA5-44F1-83B6-7B45682B3904 O analisador DMX tem precedência.
MDGUID_MDX A07CCCD0-8148-11D0-87BB-00C04FC33942 O analisador MDX tem precedência.

Você pode usar a propriedade Dialect quando esperar que a maioria das consultas usará um dialeto específico sobre qualquer outro.

A sintaxe de consulta pode ser semelhante para dialetos de linguagem, como DMX e SQL. Como a sintaxe pode ser semelhante, Analysis Services talvez não consiga deduzir o dialeto da sintaxe de consulta. Se a consulta não for executada em um dialeto, a instância do Analysis Services pode tentará executar a consulta novamente em um dialeto diferente.

Se a propriedade Dialect for definida, Analysis Services retornará erros de execução de consulta no dialeto que tem precedência, mesmo se o provedor tentar executar a consulta novamente em outro dialeto. Por exemplo, a propriedade Dialect é definida como MDGUID_DM. Primeiro, o provedor tenta executar a consulta como uma consulta de mineração de dados, mas esta consulta falha. O provedor então reenvia a consulta como uma consulta de SQL. Porém, esta consulta de SQL também falha. Como o valor da propriedade Dialect é MDGUID_DM, Analysis Services retorna uma mensagem de erro de mineração de dados, não uma mensagem de erro SQL.

Se a propriedade Dialect não for definida, Analysis Services retornará erros de execução de consulta no último dialeto usado. Por exemplo, a propriedade Dialect não está definida, e uma consulta de mineração de dados falha. O provedor então reenvia a consulta como SQL. A consulta SQL também falha. Como a propriedade Dialect não está definida, o provedor retorna uma mensagem de erro SQL, em vez de uma mensagem de erro de mineração de dados.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

Desabilitar fatos de pré-busca

Uso

Propriedade Boolean opcional, leitura/gravação,

Descrição

Quando definido como True, o mecanismo deixa de tentar pré-buscar valores para o comprimento da sessão.

O valor padrão dessa propriedade é False.

EffectiveRoles

Uso

Propriedade String opcional, somente gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

EffectiveUserName

Uso

Propriedade String opcional, somente gravação

Descrição

Especifica o nome de uma conta a ser usada para anular o nome de usuário durante uma conexão a uma instância do Analysis Services. O valor da propriedade não é normalizada; assim, a função UserName do MDX retorna o valor literal se essa propriedade é usada. Esta propriedade só pode ser usada por administradores de servidor.

Esta propriedade aceita os seguintes tipos de SID: Usuário, Grupo, Alias, WellKnownGroup, Computador.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

EndRange

Uso

Propriedade Integer opcional, somente gravação

Descrição

Especifica um valor inteiro baseado em zero que corresponde a um valor de atributo CellOrdinal. (O CellOrdinal atributo faz parte do elemento Cell na seção CellData de MDDataSet).

Usada junto com a propriedade BeginRange, o aplicativo cliente pode usar essa propriedade a limitar um conjunto de dados OLAP retornado por um comando a um intervalo de células específico. Se –1 for especificado, serão retornadas todas as células da célula especificada na propriedade BeginRange.

O valor padrão para essa propriedade é -1.

Esta propriedade pode ser usada com o método Execute.

ExecutionMode

Uso

Propriedade String opcional, somente gravação

Descrição

Reservado para uso futuro.

O valor padrão para essa propriedade é Execute.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ForceCommitTimeout

Uso

Propriedade Integer opcional, somente gravação

Descrição

Determina por quanto tempo, em segundos, a fase de confirmação de um comando XMLA que está sendo executado no momento espera antes de forçar a reversão de comandos emitidos anteriormente. A fase de confirmação corresponde a comandos XMLA, como Statement ou Process.

Um valor de zero (0) indica que a instância espera indefinidamente.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

Formato

Uso

Propriedade String opcional, somente gravação

Descrição

Determina o tipo de conjunto de resultados retornado dos métodos Discover e Execute. Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
Tabular Retorna um conjunto de resultados que usa o tipo de dados Rowset.
Multidimensional Retorna um conjunto de linhas que usa o tipo de dados MDDataSet.
Native Nenhum formato é especificado explicitamente. Analysis Services retorna o formato adequado para o comando. O tipo de resultado real é identificado pelo namespace do resultado.

O valor padrão para essa propriedade é Native.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ImpactAnalysis

Uso

Propriedade Boolean opcional, somente gravação

Descrição

Reservado para uso futuro.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

LocaleIdentifier

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Lê ou define o identificador de localidade (LCID) usado pelo método Discover ou Execute.. Para obter a lista completa de hexadecimais de identificadores de idiomas, pesquise "Identificadores de idioma", na Biblioteca MSDN do site da Microsoft.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MaximumRows

Uso

Propriedade Integer opcional, somente gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropAggregateCellUpdate

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_AGGREGATECELL_UPDATE.

O valor padrão desta propriedade é 4, equivalente a MDPROPVAL_AU_SUPPORTED.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropAxes

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_AXES.

O valor padrão para essa propriedade é 2147483647.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropDrillFunctions

Uso

Propriedade Integer opcional, somente leitura

Descrição

Determina o nível de suporte para funções de busca detalhada no servidor. Os valores a seguir são usados para compilar uma máscara de bits válida:

MDPROPVAL_MDF_BASIC (0x01)

MDPROPVAL_MDF_ASYMMETRIC (0x02)

MDPROPVAL_MDF_CALC_MEMBERS (0x04)

Os valores padrão são:

3 para SQL Server 2008

7 para SQL Server 2008 R2

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropFlatteningSupport

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_FLATTENING_SUPPORT.

O valor padrão desta propriedade é 1, equivalente a MDPROPVAL_FS_FULL_SUPPORT.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxCaseSupport

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_CASESUPPORT.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxDescFlags

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_DESCFLAGS.

O valor padrão desta propriedade é 7, equivalente a MDPROPVAL_MD_BEFORE, MDPROPVAL_MD_AFTER e MDPROPVAL_MD_SELF.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxFormulas

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_FORMULAS.

O valor padrão desta propriedade é 63, equivalente a uma combinação de MDPROPVAL_MF_WITH_CALCMEMBERS, MDPROPVAL_MF_WITH_NAMEDSETS, MDPROPVAL_MF_CREATE_CALCMEMBERS, MDPROPVAL_MF_CREATE_NAMEDSETS, MDPROPVAL_MF_SCOPE_SESSION e MDPROPVAL_MF_SCOPE_GLOBAL.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxJoinCubes

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_JOINCUBES.

O valor padrão desta propriedade é 1, equivalente a MDPROPVAL_MJC_SINGLECUBE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxMemberFunctions

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_MEMBER_FUNCTIONS.

O valor padrão desta propriedade é 15, equivalente a uma combinação de todos os valores OLE DB disponíveis.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxNamedSets

Uso

Propriedade Integer opcional, somente leitura

Descrição

Uma máscara de bits dos valores listados na tabela a seguir.

ValorDescrição
0x01 MDPROPVAL_MNS_BASIC.
0x02 MDPROPVAL_MNS_DYNAMIC.
0x04 MDPROPVAL_MNS_DISPLAYFOLDER.
0x08 MDPROPVAL_MNS_CAPTION.

Um valor de 15 é o padrão para essa propriedade.

MdpropMdxNonMeasureExpressions

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_NONMEASURE_EXPRESSIONS.

O valor padrão desta propriedade é zero (0), equivalente a MDPROPVAL_NME_ALLDIMENSIONS.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxNumericFunctions

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_NUMERIC_FUNCTIONS.

O valor padrão desta propriedade é 2047, equivalente a uma combinação de MDPROPVAL_MNF_MEDIAN, MDPROPVAL_MNF_VAR, MDPROPVAL_MNF_STDDEV, MDPROPVAL_MNF_RANK, MDPROPVAL_MNF_AGGREGATE, MDPROPVAL_MNF_COVARIANCE, MDPROPVAL_MNF_CORRELATION, MDPROPVAL_MNF_LINREGSLOPE, MDPROPVAL_MNF_LINREGVARIANCE, MDPROPVAL_MNF_LINREG2 e MDPROPVAL_MNF_LINREGPOINT.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxObjQualification

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_OBJQUALIFICATION.

O valor padrão desta propriedade é 496, equivalente a uma combinação de MDPROPVAL_MOQ_DIM_HIER, MDPROPVAL_MOQ_DIMHIER_LEVEL, MDPROPVAL_MOQ_DIMHIER_MEMBER, MDPROPVAL_MOQ_LEVEL_MEMBER e MDPROPVAL_MOQ_MEMBER_MEMBER.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxOuterReference

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_OUTERREFERENCE.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxQueryByProperty

Uso

Propriedade Boolean opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_QUERYBYPROPERTY.

O valor padrão desta propriedade é TRUE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxRangeRowset

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_RANGEROWSET.

O valor padrão desta propriedade é 4, equivalente a MDPROPVAL_RR_UPDATE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxSetFunctions

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_SET_FUNCTIONS.

O valor padrão desta propriedade é 524287, equivalente a uma combinação de MDPROPVAL_MSF_TOPPERCENT, MDPROPVAL_MSF_BOTTOMPERCENT, MDPROPVAL_MSF_TOPSUM, MDPROPVAL_MSF_BOTTOMSUM, MDPROPVAL_MSF_PERIODSTODATE, MDPROPVAL_MSF_LASTPERIODS, MDPROPVAL_MSF_YTD, MDPROPVAL_MSF_QTD, MDPROPVAL_MSF_MTD, MDPROPVAL_MSF_WTD, MDPROPVAL_MSF_DRILLDOWNMEMBER, MDPROPVAL_MSF_DRILLDOWNLEVEL, MDPROPVAL_MSF_DRILLDOWNMEMBERTOP, MDPROPVAL_MSF_DRILLDOWNMEMBERBOTTOM, MDPROPVAL_MSF_DRILLDOWNLEVEL, MDPROPVAL_MSF_DRILLDOWNLEVELTOP, MDPROPVAL_MSF_DRILLDOWNLEVELBOTTOM, MDPROPVAL_MSF_DRILLUPMEMBER, MDPROPVAL_MSF_DRILLUPLEVEL e MDPROPVAL_MSF_TOGGLEDRILLSTATE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxSlicer

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_SLICER.

O valor padrão desta propriedade é 2, equivalente a MDPROPVAL_MS_SINGLETUPLE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxStringCompop

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_MDX_STRING_COMPOP.

O valor padrão desta propriedade é 15, equivalente a uma combinação de MDPROPVAL_MSC_LESSTHAN, MDPROPVAL_MSC_GREATERTHAN, MDPROPVAL_MSC_LESSTHANEQUAL e MDPROPVAL_MSC_GREATERTHANEQUAL.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdpropMdxSubQueries

Uso

Propriedade Integer opcional, somente leitura

Descrição

Indica o nível de suporte das subconsultas em MDX. Uma máscara de bits dos valores listados na tabela a seguir.

ValorDescrição
0x01 MDPROPVAL_MSQ_BASIC.
0x02 MDPROPVAL_MSQ_ARBITRARYSHAPE.
0x04 MDPROPVAL_MSQ_NONVISUAL.
0x08 MDPROPVAL_MSQ_CALCMEMBERS.
0x10 MDPROPVAL_MSQ_CALCMEMBERS2

O valor 31 é o valor padrão para essa propriedade no SQL Server 2008 R2.

O valor 15 é o valor padrão para essa propriedade no SQL Server 2008.

O valor 3 é o valor padrão para essa propriedade no SQL Server 2005 Analysis Services.

MdpropNamedLevels

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_NAMED_LEVELS.

O valor padrão desta propriedade é 3, equivalente a uma combinação de MDPROPVAL_NL_NAMEDLEVELS e MDPROPVAL_NL_NUMBEREDLEVELS.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MdxMissingMemberMode

Uso

Propriedade String opcional, somente gravação

Descrição

Indica se sentindo os membros ausentes são ignorados em instruções MDX.

Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
Default Usar valor gerado pela instância Analysis Services.
Error Gerar um erro.
Ignore Sempre ignorar membros ausentes.

Esta propriedade é equivalente à propriedade OLE DB DBPROP_MDX_MISSING_MEMBER_MODE.

O valor padrão para essa propriedade é Default.

Esta propriedade pode ser usada com os métodos Discover e Execute.

MDXSupport

Uso

Propriedade String opcional, somente leitura

Descrição

Especifica uma enumeração que descreve o grau de suporte de MDX.

Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
Core Todas as opções de MDX são com suporte.
ObservaçãoObservação
Atualmente, o único valor que a enumeração contém é Core. Em versões futuras, serão definidos outros valores para esta enumeração.

O valor padrão para essa propriedade é Core.

Esta propriedade pode ser usada com o método Discover.

NonEmptyThreshold

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

Senha

Uso

Propriedade String opcional, somente gravação

ObservaçãoObservação
Esta propriedade não é mais suportada.
Descrição

Para compatibilidade com versões anteriores, esta propriedade é ignorada sem gerar um erro quando usada com o método Execute ou Discover.

ProviderName

Uso

Propriedade String opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_DBMSNAME.

O valor padrão desta propriedade é "OLAP Server".

Esta propriedade pode ser usada com o método Discover.

ProviderType

Uso

Propriedade Integer opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_DATASOURCE_TYPE.

O valor padrão para essa propriedade é 6.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ProviderVersion

Uso

Propriedade String opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB DBPROP_DBMSVER.

O valor padrão para esta propriedade é a versão da instância Analysis Services.

Esta propriedade pode ser usada com o método Discover.

ReadOnlySession

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Reservado para uso futuro.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

RealTimeOlap

Uso

Propriedade Boolean opcional, leitura/gravação

Descrição

Quando definida como TRUE, indica que todas as partições que estão escutando notificações de tabelas devem ser consultadas em tempo real, ignorando o cache. Esta propriedade é equivalente à propriedade OLE DB DBPROP_MSMD_REAL_TIME_OLAP.

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ReturnCellProperties

Uso

Propriedade Boolean opcional, leitura/gravação

Descrição

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

Funções

Uso

Propriedade String opcional, leitura/gravação

Descrição

Especifica uma cadeia de caracteres delimitada por vírgula dos nomes de função com o qual um aplicativo cliente se conecta a uma instância do Analysis Services. Esta propriedade permite que o usuário se conecte usando uma função diferente daquela que ele está usando no momento. Por exemplo, um administrador de servidor pode se conectar a um cubo como um membro de uma função para testar as permissões concedidas a essa função. Esse usuário deve ser um membro da função especificada para se conectar usando esta propriedade.

Observação importanteImportante
Nomes de função diferenciam maiúsculas de minúsculas, e não devem ser usados espaços entre os nomes de função delimitados por vírgula. Caso contrário, erros e resultados inesperados podem ser voltados por consultas a conjuntos de células protegidos.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SafetyOptions

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Determina se bibliotecas não seguras podem ser registradas e carregadas por aplicativos cliente.

O valor desta propriedade também determina se a palavra-chave PASSTHROUGH é permitida em cubos locais. Ocorre um erro nas situações seguintes:

  • Se um aplicativo cliente tenta criar um cubo local com uma instrução INSERT INTO que contenha a palavra-chave PASSTHROUGH.

  • Se um aplicativo cliente tenta atualizar um cubo local que contenha uma instrução INSERT INTO que utilize a palavra-chave PASSTHROUGH.

Essa propriedade pode ter os valores listados na tabela a seguir.

NomeValorDescrição
DBPROPVAL_MSMD_SAFETY_OPTIONS_DEFAULT 0 Este valor é tratado como DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE. Para conexões a um cubo local, este valor depende se propriedade de cadeia de conexão CREATECUBE é usada. Se a propriedade da cadeia de conexão CREATECUBE é usada, este valor é igual a DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL. Caso contrário, este valor é igual a DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE.
DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_ALL 1
Este valor ativa todas as bibliotecas de função definida pelo usuário sem verificar se eles estão seguros para inicialização e scripting. Para conexões a cubos locais, esse valor permite o uso de procedimentos armazenados e da palavra-chave PASSTHROUGH em instruções INSERT INTO.
Observação sobre segurançaObservação sobre segurança
Não recomendamos essa opção.
DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFE 2 Este valor ativa verifica se todas as classes de uma biblioteca específica de função definida pelo usuário estão marcadas para certificar-se de que elas estejam seguras para inicialização e scripting. Para conexões a cubos locais, esse valor impede o uso da palavra-chave PASSTHROUGH em instruções INSERT INTO e de procedimentos armazenados onde a propriedade PermissionSet não está definida como Segura. Este valor também remove ações no conjunto de linhas de esquema MDSCHEMA_ACTIONS que tenham um valor HTML ou COMMAND na coluna ACTION_TYPE ou um valor de URL na coluna ACTION_TYPE e um valor na coluna CONTENT que não comece com "http://" ou "https://".
DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_NONE 3 Este valor impede que funções definidas pelo usuário sejam usadas durante a sessão. Para conexões a cubos locais, esse valor impede o uso de todos procedimentos armazenados e da palavra-chave PASSTHROUGH em instruções INSERT INTO. Este valor também remove todas as ações no conjunto de linhas de esquema MDSCHEMA_ACTIONS.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SecuredCellValue

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Especifica o código de erro e os valores das propriedades de células Value e Formatted Value a serem retornados quando tentar acessar uma célula segura.

Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
0 (Padrão) Para compatibilidade com versões anteriores, este valor é o mesmo que 1. O significado deste valor padrão está sujeito a alteração em versões futuras.
1 Retorna: HRESULT = NO_ERROR A propriedade Value da célula contém o resultado como um tipo de dados variante. A cadeia de caracteres "#N/A" é retornada na propriedade Formatted Value.
2 Retorna um erro como o valor de HRESULT.
3 Retorna NULL nas propriedades Value e Formatted Value.
4 Retorna um zero numérico (0) na propriedade Value e retorna um zero formatado na propriedade Formatted Value. Por exemplo, 0,00 é retornado na propriedade Formatted Value para uma célula cuja propriedade Format seja "#. ##."
5 Retorna a cadeia de caracteres "#SEC" nas propriedades Value e Formatted Value.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ServerName

Uso

Propriedade String opcional, somente leitura

Descrição

Esta propriedade é equivalente à propriedade OLE DB, DBPROP_SERVERNAME.

O valor padrão desta propriedade é o nome da instância Analysis Services.

Esta propriedade pode ser usada com os métodos Discover e Execute.

ShowHiddenCubes

Uso

Propriedade Boolean opcional, leitura/gravação

Descrição

Reservado para uso futuro.

O valor padrão desta propriedade é FALSE.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SQLQueryMode

Uso

Propriedade String opcional, leitura/gravação

Descrição

Determina se cálculos são incluídos em consultas SQL.

Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
Data Nenhum cálculo é incluído.
Calculated São retornados cálculos.
IncludeEmpty São retornados cálculos e linhas vazias.

O valor padrão para essa propriedade é Calculated.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SQLSupport

Uso

Propriedade Integer opcional, somente leitura

Descrição

O valor padrão para essa propriedade é 512.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SspropInitAppName

Uso

Propriedade String opcional, leitura/gravação

Descrição

Contém o nome do aplicativo cliente.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SspropInitPacketsize

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Contém a ID do aplicativo cliente.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

SspropInitWsid

Uso

Propriedade String opcional, leitura/gravação

Descrição

Contém a ID da estação de trabalho cliente.

Não há um valor padrão para esta propriedade.

Esta propriedade pode ser usada com os métodos Discover e Execute.

StateSupport

Uso

Propriedade String opcional, somente leitura

Descrição

Especifica o grau de suporte para a capacidade de manutenção de status do processo.

Essa propriedade pode ter os valores listados na tabela a seguir.

ValorDescrição
None Não há suporte para a capacidade de manutenção de status do processo.
Sessions A capacidade de manutenção de status do processo é fornecida por suporte de sessão.

Para obter mais informações sobre suporte para a capacidade de manutenção de status do processo e sessão, consulte Gerenciando conexões e sessões (XMLA).

O valor padrão para essa propriedade é Sessions.

Esta propriedade pode ser usada com o método Discover.

Timeout

Uso

Propriedade Integer opcional, leitura/gravação

Descrição

Especifica o tempo máximo, em segundos, que a instância Analysis Services deve esperar para que uma solicitação seja bem-sucedida antes de retornar um erro. Esta propriedade também determina o tempo máximo que a instância deve esperar para que uma atualização em uma tabela de write-back seja bem-sucedida antes de retornar um erro; equivalente à propriedade de cadeia de conexão Writeback Timeout.

O valor padrão desta propriedade é zero (0).

Esta propriedade pode ser usada com os métodos Discover e Execute.

TransactionDDL

Uso

Propriedade Integer opcional, somente leitura

Descrição

Reservado para uso futuro.

O valor padrão para essa propriedade é 0.

Esta propriedade pode ser usada com os métodos Discover e Execute.

UserName

Uso

Propriedade String opcional, somente leitura

ObservaçãoObservação
Esta propriedade não é mais suportada.
Descrição

Especifica uma cadeia de caracteres que retorna o nome de usuário que a instância Analysis Services associa ao comando. Para compatibilidade com versões anteriores, esta propriedade é ignorada sem gerar um erro quando usada com o método Execute ou Discover. Esta propriedade é equivalente à propriedade OLE DB DBPROP_USERNAME.

O valor padrão desta propriedade é o nome de usuário que abriu a sessão ou conexão atual.

Esta propriedade pode ser usada com o método Execute.

VisualMode

Uso

Propriedade Integer opcional, somente gravação

Descrição

Esta propriedade é equivalente à propriedade OLE DB MDPROP_VISUALMODE.

O valor padrão desta propriedade é zero (0), equivalente a DBPROPVAL_VISUAL_MODE_DEFAULT.

Esta propriedade pode ser usada com os métodos Discover e Execute.

Consulte também

Referência