Compartilhar via


OLE DB para propriedades OLAP usadas pelo Excel

O Microsoft Excel usa um provedor OLE DB para OLAP (Processamento Analítico OnLine) para se conectar a cubos OLAP. Ao se conectar a um cubo OLAP, o Excel lê e define várias propriedades OLE DB e OLE DB para OLAP. O Excel considera as propriedades de Conexão, Propriedades de Informações da Fonte de Dados, Consultas de Conjunto de Linhas da Esquema e propriedades de Célula.

Em vez de discutir todas as propriedades existentes, este tópico se concentrará nas propriedades com um relacionamento exclusivo com o Excel. As conexões OLAP no Excel são usadas para Tabelas Dinâmicas e Fórmulas OLAP. Quando estiver testando um provedor OLAP existente, é recomendável que você faça o Excel ler um conjunto de propriedades de provedor para determinar se um provedor OLAP dá suporte aos recursos necessários para o design e a funcionalidade da Tabela Dinâmica OLAP. Se o provedor não der suporte a certos recursos, outros recursos que dependam deles serão desabilitados ou ficarão limitados. Outras propriedades são definidas para obter o comportamento desejado e, se essas propriedades não forem implementadas para um provedor OLAP, o Excel poderá não funcionar com ele.

Propriedades de conexão

Conjunto de propriedades Propriedade Definida se Definida como
DBPROPSET_MSOLAPINIT DBPROP_MSMD_SAFETY_OPTIONS Com suporte Chave de reg OLAPUDFSecurity ou DBPROPVAL_MSMD_SAFETY_OPTIONS_ALLOW_SAFESee também: Propriedade Opções de Segurança.
DBPROPSET_MSOLAPINIT DBPROP_MSMD_MDXCOMPATIBILITY Com suporte DBPROP_MSMD_MDXCOMPATIBILITY_70See também: Propriedade de compatibilidade MDX.
DBPROPSET_MSOLAPINIT DBPROP_MSMD_SOURCE_DSN_SUFFIX DBPROP_MSMD_SOURCE_DSN em DBPROPSET_MSOLAPINIT estiver presente Cadeia de caracteres "Prompt=CompleteRequired; Identificador de janela=0x<hwnd>"Veja também: propriedade Source_DSN_Suffix.
DBPROPSET_MSOLAPINIT DBPROP_MSMD_MDX_MISSING_MEMBER_MODE Com suporte Se houver suporte para a propriedade, o Excel a definirá como a cadeia de caracteres "Erro". Será ignorada se não tiver suporte.
DBPROPSET_DBINIT DBPROP_INIT_LCID Com suporte Definir antes de fazer a conexão. É possível especificar qualquer LCID a ser usada na conexão. Se as traduções forem ativadas para a conexão, o Excel definirá isso como o idioma da interface do usuário (padrão). Se a propriedade não tiver suporte, o Excel não terá problemas além de perder a funcionalidade de ter traduções baseadas no idioma da interface do usuário.
DBPROPSET_DBINIT DBPROP_INIT_PROMPT Com suporte Não é específica de OLAP. Definir antes de fazer a conexão. Se a configuração dessa propriedade falhar porque determinado valor não tem suporte, o Excel irá ignorar a falha.
DBPROPSET_DBINIT DBPROP_AUTH_PERSIST_SENSITIVE_AUTHINFO Com suporte Não é específica de OLAP. Definir antes de fazer a conexão. Aparentemente, o Excel sempre define isso como Verdadeiro.
DBPROPSET_DBINIT DBPROP_INIT_HWND Com suporte Não é específica de OLAP. Definir antes de fazer a conexão. O Excel define isso como a janela principal do aplicativo de forma que o provedor exiba o alerta usando a janela pai correta.
DBPROPSET_DBINIT DBPROP_INIT_ASYNCH Com suporte Não específico do OLAP. Defina antes de fazer a conexão. O Excel define essa propriedade como DBPROPVAL_ASYNCH_INITIALIZE com base em uma configuração do Registro (você também poderá desabilitá-la usando uma configuração do Registro). Se a propriedade não tiver suporte, o Excel a ignorará e não a definirá.
DBPROPSET_DBINIT DBPROP_CMD_PROMPT Com suporte Não é específica de OLAP. Definir antes de fazer a conexão.
DBPROPSET_DBINIT DBPROP_CMD_HWND Com suporte Não é específica de OLAP. Definir antes de fazer a conexão.

Informações da fonte de dados

Conjunto de propriedades Propriedade Valor Usar
DBPROPSET_MDX_EXTENSIONS DBPROP_MSMD_MDX_DDL_EXTENSIONS Se bit for definido como DBPROPVAL_MDX_DLL_CREATESESSIONCUBE. O recurso de agrupamento das Tabelas Dinâmicas do OLAP será habilitado se CREATE SESSION CUBE houver suporte.
DBPROPSET_MDX_EXTENSIONS DBPROP_MSMD_MDX_DDL_EXTENSIONS Se bit for definido como DBPROPVAL_MDX_DDL_REFRESHCUBE. Se REFRESH CUBE houver suporte para o comando, o Excel o executará quando uma Tabela Dinâmica OLAP for atualizada.
DBPROPSET_MDX_EXTENSIONS DBPROP_MSMD_MDX_CALCMEMB_EXTENSIONS Se bit for definido como DBPROPVAL_MDX_CALCMEMB_ADD. O recurso mostrar membros calculados na Tabela Dinâmica OLAP será habilitado se ADDCALCULATEDMEMBERS houver suporte em MDX (Expressões Multidimensionais).
DBPROPSET_DATASOURCEINFO MDPROP_MDX_FORMULAS Se ambos os bits forem definidos como MDPROPVAL_MF_SCOPE_SESSION, MDPROPVAL_MF_CREATE_CALCMEMBERS. Se o provedor dá suporte à criação de membros de sessão ( CREATE SESSION MEMBER), o Excel habilita esse recurso em Tabelas Dinâmicas OLAP (disponível apenas no modelo de objeto no Excel).
DBPROPSET_SESSION DBPROP_VISUALMODE Se tiver suporte (e se a subseleção não tiver suporte, consulte MDPROP_MDX_SUBQUERIES a seguir). Habilita o controle de itens ocultos Include em totais (alternar totais visuais).
DBPROPSET_DATASOURCEINFO MDPROP_MDX_SUBQUERIES Se os dois bits mais baixos estiverem definidos (com isso, o Excel não dá suporte a totais não visuais, consulte DBPROP_VISUALMODE acima). Habilita a filtragem de Rótulo, Data e Valor em Tabelas Dinâmicas do Excel. Geralmente, usa a construção de consulta MDX do Excel. Observe que esta propriedade foi introduzida com o SQL Server 2005 Service Pack 2. O valor está sempre VARIANT_TRUE em msolap90.dll.
DBPROPSET_DATASOURCEINFO MDPROP_MDX_DRILL_FUNCTIONS Se os dois bits mais baixos dessa propriedade forem definidos, o Excel a interpretará como o servidor que dá suporte à perfuração baseada em tupla com as DrillDownLevel funções e DrillDownMember . No entanto, o Excel só permite a perfuração de MDPROP_MDX_SUBQUERIES atributos se os dois bits mais baixos também forem definidos (subseleções com suporte).
DBPROPSET_DATASOURCEINFO MDPROP_FLATTENING_SUPPORT Verifique se está definida como MDPROPVAL_FS_FULL_SUPPORT. Lido pelo Excel e se ele não estiver definido como MDPROPVAL_FS_FULL_SUPPORT, ocorrerá um erro porque o Excel não o considera um provedor OLAP.
DBPROPSET_DATASOURCEINFO MDPROP_NAMED_LEVELS O Excel verifica se o bit mais baixo está definido (MDPROPVAL_NL_NAMEDLEVELS). Se o bit mais baixo dessa propriedade não estiver definido, o Excel falhará.
DBPROPSET_DATASOURCEINFO MDPROP_MDX_SET_FUNCTIONS O Excel consulta essa propriedade, mas não tem efeito relevante para recurso.
DBPROPSET_DATASOURCEINFO DBPROP_DBMSVER O Excel verifica se esse valor é uma cadeia de caracteres. O Excel não verifica o valor real dessa propriedade, só verifica se é uma cadeia de caracteres. Se não for, o Excel não conseguirá se conectar.
DBPROPSET_DATASOURCEINFO DBPROP_DATASOURCE_TYPE O Excel verifica se o segundo bit mais baixo está definido (DBPROPVAL_DST_MDP). Se o bit mais baixo estiver definido, o provedor será considerado como multidimensional (OLAP).
DBPROPSET_ROWSET DBPROP_ROWSET_ASYNCH Se tiver suporte. O Excel tenta definir isso como DBPROPVAL_ASYNCH_INITIALIZE , mas se isso falhar, o Excel voltará ao modo síncrono. Se houver suporte, ele permitirá que o Excel dê suporte ao usuário pressionando a chave Esc para interromper a execução da consulta antes de ser concluída.

Consultas de conjunto de linhas de esquema

Conjunto de linhas de esquema Coluna Valor Controles
MDSCHEMA_CUBES IS_DRILLTHROUGH_ENABLED TRUE Se definido como TRUE, o recurso de drill-through (detalhamento) será habilitado para células da área de valores da Tabela Dinâmica OLAP.
MDSCHEMA_HIERARCHIES ESTRUTURA MD_STRUCTURE_UNBALANCED O Excel tem uma manipulação especial de filtragem para hierarquias desbalanceadas, para que sejam marcadas como tal para fins de controle.
MDSCHEMA_HIERARCHIES HIERARCHY_ORIGIN MD_ORIGIN_ATTRIBUTE definido e não MD_ORIGIN_USER_DEFINED O Excel tem uma manipulação especial de hierarquias de atributos em Tabelas Dinâmicas OLAP, para que as hierarquias de atributos sejam marcadas como tal.
MDSCHEMA_HIERARCHIES HIERARCHY_DISPLAY_FOLDER Com base nessa propriedade, a Lista de Campos da Tabela Dinâmica exibe hierarquias em pastas sob suas dimensões.
MDSCHEMA_MEASUREGROUPS MEASUREGROUP_NAME As Measures são listadas em uma pasta representando o grupo de medidas da Lista de Campos da Tabela Dinâmica.
MDSCHEMA_MEASUREGROUPS MEASUREGROUP_CAPTION As Measures são listadas em uma pasta representando o grupo de medidas com essa legenda na Lista de Campos da Tabela Dinâmica.
MDSCHEMA_SETS SET_DISPLAY_FOLDER O Excel lê a propriedade da pasta de exibição para permitir que ela coloque conjuntos em pastas de exibição na Lista de Campos da Tabela Dinâmica.
MDSCHEMA_SETS SET_CAPTION O Excel lê a legenda definida para exibição no relatório da Tabela Dinâmica e na Lista de Campos da Tabela Dinâmica.
MDSCHEMA_KPIS KPI_DISPLAY_FOLDER Os KPIs (indicadores chave de desempenho) definidos no servidor são listados na lista de campos da Tabela Dinâmica e os componentes (valor, meta, status e tendência) podem ser adicionados à área de valores. O Excel lê essa propriedade para colocar o KPI na pasta de exibição correta na Lista de Campos da Tabela Dinâmica.
MDSCHEMA_KPIS KPI_PARENT_KPI_NAME O Excel lê essa propriedade para colocar KPIs filho em subpastas em seu KPI pai na Lista de Campos de Tabela Dinâmica (se as pastas de exibição forem definidas, elas serão usadas em vez disso).
MDSCHEMA_KPIS KPI_TREND_GRAPHIC O Excel lê essa propriedade e, com base no valor, a mapeia para o ícone de formatação condicional mais próximo definido no Excel quando Tendência é adicionada à Tabela Dinâmica.
MDSCHEMA_KPIS KPI_STATUS_GRAPHIC O Excel lê essa propriedade e, com base no valor, a mapeia para o ícone de formatação condicional mais próximo definido no Excel quando Status é adicionado à Tabela Dinâmica.
MDSCHEMA_ACTIONS Recurso Ações Adicionais. O Excel expõe ações definidas pelo servidor no menu de atalho para um relatório de Tabela Dinâmica OLAP quando existirem ações no servidor para o contexto selecionado.
MDSCHEMA_MEASURES MEASURE_DISPLAY_FOLDER Lido pelo Excel para que possa colocar medidas na pasta de exibição correta na Lista de Campos da Tabela Dinâmica.
MDSCHEMA_MEASURES) EXPRESSÃO Lido pelo Excel para determinar se uma medida será calculada. Se for uma cadeia de caracteres e não estiver vazia, o Excel irá considerá-lo como uma medida calculada.
MDSCHEMA_PROPERTIES PROPERTY_NAME "MEMBER_VALUE" Esse esquema também foi usado para obter propriedades de membro regulares. O valor "MEMBER_VALUE" é um caso especial, mas há outro uso. O Excel obtém a propriedade de valor membro do atributo chave em uma dimensão restringindo-se a "MEMBER_VALUE" na coluna PROPERTY_NAME. Se o tipo de dados (DATA_TYPE) da propriedade MEMBER_VALUE do atributo chave de uma dimensão de Tempo for Date, a Tabela Dinâmica exporá a filtragem de datas em vez da filtragem de rótulos. A filtragem de datas real é feita com base na propriedade de valor do membro da chave, independente de qual hierarquia da dimensão estiver sendo filtrada.
Observação
A filtragem de datas exige suporte para subseleções (consulte MDPROP_MDX_SUBQUERIES acima).
MDSCHEMA_DISCOVER RESTRIÇÕES Dependendo do uso, o Excel restringe-se a hierarquias, níveis ou medidas ao ler o conjunto de linhas MDSCHEMA_DISCOVER para obter as RESTRIÇÕES. O Excel lê o esquema linha por linha e encontra a lista de restrições de todos os outros esquemas relevantes para obter o índice das restrições que o afetam. A coluna RESTRICTIONS tem um identificador de capítulo para outro conjunto de linhas do qual o Excel analisa a coluna NAME. Na coluna NAME, o Excel espera encontrar as cadeias de caracteres HIERARCHY_VISIBILITY, MEASURE_VISIBILITY, LEVEL_VISIBILITY (se o provedor der suporte para restrição em visibilidade). Se o Excel não conseguir encontrar <cadeias de caracteres xxx>_VISIBILITY (ou se MDSCHEMA_DISCOVER não tiver suporte) ele assumirá que o provedor não dá suporte ao retorno de itens ocultos e não consultará eles.
MDSCHEMA_LEVELS LEVEL_ATTRIBUTE_HIERARCHY_NAME Usado pelo Excel para ocultar níveis de agrupamento especiais com nomes gerados pelo sistema. Observe que isso não é necessário no Microsoft SQL Server 2005 Analysis Services Service Pack 2.
MDSCHEMA_LEVELS CUSTOM_ROLLUP_SETTINGS 0 Se não for 0, o Excel presumirá que o nível tem rollup personalizado. O Excel verifica isso em todos os níveis de cada hierarquia e, se o rollup personalizado estiver presente, algumas operações serão desabilitadas (como o agrupamento).

Propriedades da célula

Nome da propriedade

Idioma

Usar

LCID para determinar como interpretar FORMAT_STRING quando é CURRENCY.

O Excel usa essa propriedade para determinar qual símbolo de moeda usar ao formatar valores com FORMAT_STRING definido como Conversor de Moedas. Para obter mais informações, consulte Recuperando propriedades da célula.

Exemplo de definição de medida calculada que especifica a propriedade LANGUAGE do aplicativo cliente a ser captada:

CREATE MEMBER CURRENTCUBE.[Measures].[Internet Gross Profit]
AS
[Measures].[Internet Sales Amount]
-
[Measures].[Internet Total Product Cost],
FORMAT_STRING = "Currency",
BACK_COLOR = 12615680 /*R=0, G=128, B=192*/,
FORE_COLOR = 65408 /*R=128, G=255, B=0*/,
FONT_FLAGS = 3 /*Bold, Italic*/,
NON_EMPTY_BEHAVIOR = { [Internet Sales Amount], [Internet Total Product Cost] },
VISIBLE = 1,
LANGUAGE = 1033 /*Telling client application to display US currency symbol*/;|

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.