Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Este tópico documenta as propriedades da cadeia de conexão que você pode definir em uma das ferramentas de administração ou designer ou ver em cadeias de conexão criadas por aplicativos cliente que se conectam e consultam dados do Analysis Services. Dessa forma, ele abrange apenas um subconjunto das propriedades disponíveis. A lista completa inclui várias propriedades de servidor e banco de dados, permitindo que você personalize uma conexão para um aplicativo específico, independentemente de como a instância ou o banco de dados é configurado no servidor.
Os desenvolvedores que criam cadeias de conexão personalizadas no código do aplicativo devem examinar a documentação da API para o cliente ADOMD.NET para exibir uma lista mais detalhada: ConnectionString
As propriedades descritas neste tópico são usadas pelas bibliotecas de clientes do Analysis Services, ADOMD.NET, AMO e o provedor OLE DB para Analysis Services. A maioria das propriedades da cadeia de conexão pode ser usada com todas as três bibliotecas de cliente. As exceções são destacadas na descrição fornecida.
Este tópico inclui as seções a seguir:
Parâmetros de conexão em uso comum
Parâmetros de finalidade especial
Formatos de cadeia de conexão usados no Analysis Services
Criptografando cadeias de conexão
Observação
Ao definir propriedades, se você definir inadvertidamente a mesma propriedade duas vezes, a última na cadeia de conexão será usada.
Para obter mais informações sobre como especificar uma conexão do Analysis Services em aplicativos existentes da Microsoft, consulte Connect from client applications (Analysis Services).
Parâmetros de conexão em uso comum
A tabela a seguir descreve essas propriedades mais usadas ao criar uma cadeia de conexão.
| Propriedade | Descrição | Exemplo |
|---|---|---|
Data Source ou DataSource |
Especifica a instância do servidor. Essa propriedade é necessária para todas as conexões. Os valores válidos incluem o nome da rede ou o endereço IP do servidor, local ou localhost para conexões locais, uma URL se o servidor estiver configurado para acesso HTTP ou HTTPS ou o nome de um arquivo de cubo local (.cub). |
Data source=AW-SRV01 para a instância e porta padrão (TCP 2383).Data source=AW-SRV01$Finance:8081 para uma instância nomeada ($Finance) e uma porta fixa.Data source=AW-SRV01.corp.Adventure-Works.com para um nome de domínio totalmente qualificado, assumindo a instância padrão e a porta padrão.Data source=172.16.254.1 para um endereço IP do servidor, evitando a consulta ao servidor DNS, o que é útil para diagnosticar problemas de conexão. |
Initial Catalog ou Catalog |
Especifica o nome do banco de dados do Analysis Services ao qual se conectar. O banco de dados deve ser implantado no Analysis Services e você deve ter permissão para se conectar a ele. Essa propriedade é opcional para conexões AMO, mas necessária para ADOMD.NET. | Initial catalog=AdventureWorks2012 |
Provider |
Os valores válidos incluem MSOLAP ou MSOLAP.<versão>, em que <versão> é 3, 4 ou 5. No sistema de arquivos, o nome do provedor de dados é msolap110.dll para a versão do SQL Server 2012, msolap100.dll para SQL Server 2008 e 2008 R2 e msolap90.dll para SQL Server 2005. A versão atual é MSOLAP.5. Esta propriedade é opcional. Por padrão, as bibliotecas de cliente leem a versão atual do provedor OLE DB do registro. Você só precisará definir essa propriedade se precisar de uma versão específica do provedor de dados, por exemplo, para se conectar a uma instância do SQL Server 2008. Os provedores de dados correspondem às versões do SQL Server. Se sua organização usar versões atuais e anteriores do Analysis Services, você provavelmente precisará especificar qual provedor usar em cadeias de conexão que você criar manualmente. Talvez você também precise baixar e instalar versões específicas do provedor de dados em computadores que não têm a versão necessária. Você pode baixar o provedor OLE DB nas páginas do SQL Server Feature Pack no Centro de Downloads. Acesse o Microsoft SQL Server 2012 Feature Pack para baixar o provedor OLE DB do Analysis Services para SQL Server 2012. O MSOLAP.4 foi lançado no SQL Server 2008 e no SQL Server 2008 R2. A versão 2008 R2 dá suporte a pastas de trabalho PowerPivot e, às vezes, precisa ser instalada manualmente em servidores do SharePoint. Para distinguir entre essas versões, você deve verificar o número de build nas propriedades de arquivo do provedor: Vá para arquivos de programa\Microsoft Analysis Services\AS OLEDB\10. Clique com o botão direito do mouse em msolap110.dll e selecione Propriedades. Clique em Detalhes. Exiba as informações da versão do arquivo. A versão deve incluir 10.50.<buildnumber> para SQL Server 2008 R2. Para obter mais informações, consulte Instalar o provedor OLE DB do Analysis Services em servidores e provedores de dados do SharePoint usados para conexões do Analysis Services. O MSOLAP.3 foi lançado no SQL Server 2005. MSOLAP.4 foi lançado no SQL Server 2008 e novamente no SQL Server 2008 R2 MSOLAP.5 foi lançado no SQL Server 2012 |
Provider=MSOLAP.3 é usado para conexões que exigem a versão do SQL Server 2005 do provedor OLE DB para Analysis Services. |
Cube |
Nome do cubo ou da perspectiva. Um banco de dados pode conter vários cubos e perspectivas. Quando vários destinos forem possíveis, inclua o cubo ou o nome da perspectiva na cadeia de conexão. |
Cube=SalesPerspective mostra que você pode usar a propriedade da cadeia de conexão Cube para especificar o nome de um cubo ou o nome de uma perspectiva. |
Autenticação e segurança
Esta seção inclui propriedades de cadeia de conexão relacionadas à autenticação e criptografia. O Analysis Services usa somente a Autenticação do Windows, mas você pode definir propriedades na cadeia de conexão para passar um nome de usuário e senha específicos.
As propriedades são listadas em ordem alfabética.
| Propriedade | Descrição |
|---|---|
EffectiveUserName |
Use quando uma identidade de usuário final precisar ser representada no servidor. Especifique a conta em um formato de domínio\usuário. Para usar essa propriedade, o chamador deve ter permissões administrativas no Analysis Services. Para obter mais informações sobre como usar essa propriedade em uma pasta de trabalho do Excel do SharePoint, consulte Use Analysis Services EffectiveUserName no SharePoint Server 2013. Para ver como essa propriedade é usada com o Reporting Services, consulte Como usar EffectiveUserName para impersonar no SSAS.EffectiveUserName é usado em uma instalação do PowerPivot para SharePoint para capturar informações de uso. A identidade do usuário é fornecida ao servidor para que eventos ou erros que incluam a identidade do usuário possam ser registrados nos arquivos de log. No caso do PowerPivot, ele não é usado para fins de autorização. |
| Criptografar senha | Especifica se uma senha local deve ser usada para criptografar cubos locais. Os valores válidos são True ou False. O padrão é False. |
Encryption Password |
A senha usada para descriptografar um cubo local criptografado. O valor padrão está vazio. Esse valor deve ser definido explicitamente pelo usuário. |
Impersonation Level |
Indica o nível de representação que o servidor pode usar ao representar o cliente. Os valores válidos incluem: Anônimo: o cliente é anônimo para o servidor. O processo do servidor não pode obter informações sobre o cliente, nem o cliente pode ser imitado. Identificar: o processo do servidor pode obter a identidade do cliente. O servidor pode representar a identidade do cliente para fins de autorização, mas não pode acessar objetos do sistema como o cliente. Personificar: Esse é o valor padrão. A identidade do cliente pode ser mascarada, mas somente quando a conexão é estabelecida e não em todas as chamadas. Delegado: o processo do servidor pode impersonar o contexto de segurança do cliente ao atuar em nome do cliente. O processo do servidor também pode fazer chamadas de saída para outros servidores enquanto atua em nome do cliente. |
Integrated Security |
A identidade do Windows do chamador é usada para se conectar ao Analysis Services. Os valores válidos são vazio, SSPI e BASIC.Integrated Security
=
SSPI é o valor padrão para conexões TCP, permitindo a autenticação NTLM, Kerberos ou Anonymous. O valor padrão para conexões HTTP é vazio.Ao usar SSPI, ProtectionLevel deve ser definido como um dos seguintes: Connect, , PktIntegrity. PktPrivacy |
Persist Encrypted |
Defina essa propriedade quando o aplicativo cliente exigir que o objeto da fonte de dados persista informações confidenciais de autenticação, como uma senha, em formato criptografado. Por padrão, as informações de autenticação não são mantidas. |
Persist Security Info |
Os valores válidos são True e False. Quando definido como True, as informações de segurança, como a identidade do usuário ou a senha especificada anteriormente na cadeia de conexão, podem ser obtidas da conexão após a conexão ser feita. O valor padrão é False. |
ProtectionLevel |
Determina o nível de segurança usado na conexão. Os valores válidos são:None. Conexões não autenticadas ou anônimas. Não executa nenhuma autenticação nos dados enviados ao servidor.Connect. Conexões autenticadas. Autentica somente quando o cliente estabelece uma relação com um servidor.PktIntegrity. Conexões criptografadas. Verifica se todos os dados são recebidos do cliente e que não foram alterados em trânsito.PktPrivacy. Criptografia assinada, com suporte apenas para XMLA. Verifica se todos os dados são recebidos do cliente, que não foram alterados em trânsito e protege a privacidade dos dados criptografando-os.Para obter mais informações, consulte Estabelecendo conexões seguras no ADOMD.NET |
Roles |
Especifique uma lista delimitada por vírgulas de funções predefinidas para se conectar a um servidor ou banco de dados usando permissões transmitidas por essa função. Se essa propriedade for omitida, todas as funções serão usadas e as permissões efetivas serão a combinação de todas as funções. Definindo a propriedade como um valor vazio (por exemplo, Roles=' ') a conexão do cliente não tem associação de função. Um administrador que usa essa propriedade se conecta usando as permissões transmitidas pela função. Alguns comandos poderão falhar se a função não fornecer permissão suficiente. |
SSPI |
Especifica explicitamente qual pacote de segurança usar para autenticação de cliente quando Integrated Security definido como SSPI. O SSPI dá suporte a vários pacotes, mas você pode usar essa propriedade para especificar um pacote específico. Os valores válidos são Negotiate, Kerberos, NTLM e Anonymous User. Se essa propriedade não estiver definida, todos os pacotes estarão disponíveis para a conexão. |
Use Encryption for Data |
Criptografa transmissões de dados. Os valores possíveis são True e False. |
User ID=...; Password= |
User ID e Password são usados juntos. O Analysis Services representa a identidade do usuário especificada por meio dessas credenciais. Em uma conexão do Analysis Services, colocar credenciais na linha de comando é usado somente quando o servidor é configurado para acesso HTTP e você especificou a autenticação Básica em vez de segurança integrada no diretório virtual do IIS.O nome de usuário e a senha devem ser as credenciais de uma identidade do Windows, uma conta de usuário local ou de domínio. Observe que User ID tem um espaço inserido. Outros aliases dessa propriedade incluem UserName (sem espaço) e UID. Apelido para Password é PWD. |
Parâmetros de finalidade especial
Esta seção descreve o restante dos parâmetros de cadeia de conexão. Eles são usados para garantir comportamentos de conexão específicos exigidos por um aplicativo.
As propriedades são listadas em ordem alfabética.
| Propriedade | Descrição |
|---|---|
Application Name |
Define o nome do aplicativo associado à conexão. Esse valor pode ser útil ao monitorar eventos de rastreamento, especialmente quando você tem vários aplicativos acessando os mesmos bancos de dados. Por exemplo, adicionar o Nome do Aplicativo='test' a uma cadeia de conexão faz com que o 'teste' apareça em um rastreamento do SQL Server Profiler, conforme mostrado na captura de tela a seguir:
Os aliases desta propriedade incluem sspropinitAppName, AppName. Para obter mais informações, consulte Usar o parâmetro Nome do Aplicativo ao se conectar ao SQL Server. |
AutoSyncPeriod |
Define a frequência (em milissegundos) da sincronização de cache do cliente e do servidor. ADOMD.NET fornece cache de cliente para objetos usados com frequência que têm sobrecarga de memória mínima. Isso ajuda a reduzir o número de viagens de ida e volta para o servidor. O padrão é 10000 milissegundos (ou 10 segundos). Quando definido como nulo ou 0, a sincronização automática é desativada. |
Character Encoding |
Define como os caracteres são codificados na solicitação. Os valores válidos são Padrão ou UTF-8 (estes são equivalentes) e UTF-16 |
CompareCaseSensitiveStringFlags |
Ajusta comparações de cadeia de caracteres sensíveis a maiúsculas e minúsculas para uma localidade especificada. Para obter mais informações sobre como definir essa propriedade, consulte a Propriedade CompareCaseSensitiveStringFlags. |
Compression Level |
Se TransportCompression for XPRESS, você poderá definir o nível de compactação para controlar a quantidade de compactação usada. Os valores válidos são de 0 a 9, com 0 com menos compactação e 9 com mais compactação. O aumento da compactação reduz o desempenho. O valor padrão é 0. |
Connect Timeout |
Determina a quantidade máxima de tempo (em segundos) que o cliente tenta uma conexão antes de atingir o tempo limite. Se uma conexão não tiver êxito nesse período, o cliente deixará de tentar se conectar e gerará um erro. |
MDX Compatibility |
A finalidade dessa propriedade é garantir um conjunto consistente de comportamentos MDX para aplicativos que emitem consultas MDX. O Excel, que usa consultas MDX para preencher e calcular uma Tabela Dinâmica conectada ao Analysis Services, define essa propriedade como 1, para garantir que os membros de espaço reservado em hierarquias irregulares estejam visíveis em uma Tabela Dinâmica. Os valores válidos incluem 0, 1, 2. 0 e 1 expõem membros de espaço reservado; 2 não. Se isso estiver vazio, 0 será assumido. |
MDX Missing Member Mode=Error |
Indica se os membros ausentes são ignorados em instruções MDX. Os valores válidos são Padrão, Erro e Ignorar. O padrão usa um valor definido pelo servidor. O erro gera um erro quando um membro não existe. Ignorar especifica que os valores ausentes devem ser ignorados. |
Optimize Response |
Uma máscara de bits que indica quais das seguintes otimizações para respostas de consulta estão habilitadas. 0x01: Padrão. Usar o NormalTupleSet 0x02: Usar quando as segmentações estiverem vazias |
Packet Size |
Um tamanho de pacote de rede (em bytes) entre 512 e 32.767. O tamanho do pacote de rede padrão é 4096. |
Protocol Format |
Define o formato do XML enviado ao servidor. Os valores válidos são Default, XML ou Binary. O protocolo é XMLA. Você pode especificar que o XML seja enviado em forma compactada (esse é o padrão), como XML bruto ou em um formato binário. O formato binário codifica elementos XML e atributos, tornando-os menores. Compactação é um formato proprietário que reduz ainda mais o tamanho de solicitações e respostas. Formatos binários e compactação são usados para acelerar solicitações e respostas de transferência de dados. Você deve usar uma biblioteca de clientes na conexão se estiver usando formato binário ou compactado. O provedor OLE DB pode formatar solicitações e respostas em formato binário ou compactado. AMO e ADOMD.NET formatam as solicitações como Texto, mas aceitam respostas em formato binário ou compactado. Essa propriedade de cadeia de conexão é equivalente às configurações do servidor EnableBinaryXML e EnableCompression. |
Real Time Olap |
Defina essa propriedade para ignorar o cache, fazendo com que todas as partições ouçam ativamente as notificações de consulta. Por padrão, essa propriedade não está definida. |
Safety Options |
Define o nível de segurança para funções e ações definidas pelo usuário. Os valores válidos são 0, 1, 2. Em uma conexão do Excel, essa propriedade é Opções de Segurança=2. Detalhes sobre essa opção podem ser encontrados em ConnectionString. |
SQLQueryMode |
Especifica se as consultas SQL incluem cálculos. Os valores válidos são Data, Calculated, IncludeEmpty. Os dados significam que nenhum cálculo é permitido. "Calculated permite cálculos." IncludeEmpty permite que cálculos e linhas vazias sejam retornados no resultado da consulta. |
Timeout |
Especifica por quanto tempo (em milissegundos) a biblioteca de clientes aguarda a conclusão de um comando antes de gerar um erro. |
Transport Compression |
Define como as comunicações de cliente e servidor são compactadas quando a compactação é especificada por meio da Protocol Format propriedade. Os valores válidos são Default, None, Compressed e gzip. O padrão é sem compactação para TCP ou gzip para HTTP. Nenhum indica que nenhuma compactação é usada. A compactação usa o método XPRESS (SQL Server 2008 e versões posteriores).
gzip é válido apenas para conexões HTTP, em que a solicitação HTTP inclui Accept-Encoding=gzip. |
UseExistingFile |
Usado quando se conecta a um cubo local. Essa propriedade especifica se o cubo local é substituído. Os valores válidos são True ou False. Se definido como True, o arquivo de cubo deverá existir. O arquivo existente será o destino da conexão. Se definido como False, o arquivo de cubo será sobrescrito. |
VisualMode |
Defina essa propriedade para controlar como os membros são agregados quando a segurança da dimensão é aplicada. Para dados de cubo que todos têm permissão para ver, agregar todos os membros faz sentido porque todos os valores que contribuem para o total são visíveis. No entanto, se você filtrar ou restringir dimensões com base na identidade do usuário, mostrar um total com base em todos os membros (combinando valores restritos e permitidos em um único total) poderá ser confuso ou mostrar mais informações do que deveria ser revelado. Para especificar como os membros são agregados quando a segurança de dimensão é aplicada, você pode definir essa propriedade como True para usar apenas valores permitidos na agregação ou False para excluir valores restritos do total. Quando definido na cadeia de conexão, esse valor se aplica ao nível de cubo ou perspectiva. Em um modelo, você pode controlar totais visuais em um nível mais granular. Os valores válidos são 0, 1 e 2. 0 é o padrão. Atualmente, o comportamento padrão é equivalente a 2, em que as agregações incluem valores ocultos do usuário. 1 exclui valores ocultos do total. Esse é o padrão para o Excel. 2 inclui valores ocultos no total. Esse é o valor padrão no servidor. Os aliases desta propriedade incluem Visual Total ou Default MDX Visual Mode. |
Reservado para uso futuro
As propriedades a seguir são permitidas em uma cadeia de conexão, mas não estão operacionais nas versões atuais do Analysis Services.
Usuário autenticado
Autenticação de cache
Modo cache (o uso dessa propriedade foi investigado em versões anteriores. Embora você possa encontrar postagens no blog recomendando seu uso, evite definir essa propriedade, a menos que seja instruído pelo Suporte da Microsoft).
Política de Cache
Taxa de cache
Proporção de Cache 2
Limite de depuração dinâmica
Modo de Depuração
Modo
SQLCompatibility
Usar o Cache de Fórmulas
Cadeias de conexão de exemplo
Esta seção mostra a cadeia de conexão que você provavelmente usará ao configurar uma conexão do Analysis Services em aplicativos comumente usados.
Cadeia de conexão genérica
Você poderá usar uma cadeia de conexão como esta se estiver configurando uma conexão do Reporting Services.
Data source=<servername>; initial catalog=<databasename>
Cadeia de conexão no Excel
A cadeia de conexão padrão do ADOMD.NET no Excel especifica o provedor de dados, o servidor, o nome do banco de dados e a segurança integrada do Windows. O nível de compatibilidade do MDX é sempre definido como 1. Embora você possa alterar o valor da sessão atual, o Excel redefinirá a compatibilidade do MDX para1 quando o arquivo for aberto em seguida.
Provider=MSOLAP.5;Integrated Security=SSPI;Persist Security Info=True;Initial Catalog=Adventure Works DW 2008R2;Data Source=AW-SRV01;MDX Compatibility=1;Safety Options=2;MDX Missing Member Mode=Error
Para obter mais informações, consulte Conexões de Dados, Fontes de Dados e Cadeias de Conexão no Reporting Services e Autenticação de Dados para Serviços do Excel no SharePoint Server 2013.
Formatos de cadeia de conexão usados no Analysis Services
Esta seção lista todos os formatos de cadeia de conexão compatíveis com o Analysis Services. Com exceção das conexões com bancos de dados PowerPivot, você pode especificar essas cadeias de conexões em aplicativos que se conectam ao Analysis Services.
Conexões nativas (ou diretas) com o servidor
Data Source=server[:port][\instance] em que "port" e "\instance" são opcionais. Por exemplo, especificar "Data Source=server1" abre uma conexão com a instância padrão (e a porta padrão 2383) em um servidor chamado "server1".
"Data Source=server1:port1" abrirá uma conexão com uma instância do Analysis Services em execução na porta "port1" em "server1".
"Data Source=server1\instance1" abrirá uma conexão com o SQL Browser (em sua porta padrão 2382), resolverá a porta da instância nomeada "instance1" e abrirá a conexão com essa porta do Analysis Services.
"Data Source=server1:port1\instance1" abrirá uma conexão com o SQL Browser em "port1", resolverá a porta da instância nomeada "instance1" e abrirá a conexão com essa porta do Analysis Services.
Conexões de cubo local (arquivos .cub)
Data Source=<path>, por exemplo, "Data Source=c:\temp\a.cub"
Conexões http(s) com msmdpump.dll
Data Source=<URL>, em que a URL é o endereço HTTP ou HTTPS para a pasta virtual do IIS que contém o msmdpump.dll. Para obter mais informações, consulte Configurar o acesso HTTP ao Analysis Services no IIS (Serviços de Informações da Internet) 8.0.
Conexões http(s) com pastas de trabalho do PowerPivot (arquivos.xlsx, .xlsb ou .xlsm)
Data Source=<URL>, em que a URL é o caminho do SharePoint para uma pasta de trabalho PowerPivot que foi publicada em uma biblioteca do SharePoint. Por exemplo, "Fonte de Dados=https://localhost/Shared Documentos/Sales.xlsx".
Conexões http(s) a arquivos de Modelo Semântico de BI
Data Source=<URL> em que a URL é o caminho do SharePoint para o arquivo .bism. Por exemplo, "Data Source=https://localhost/Shared Documentos/Sales.bism".
Conexões do PowerPivot inseridas
Data Source=$Embedded$ onde $embedded$ é um moniker que se refere a um modelo de dados PowerPivot inserido dentro da pasta de trabalho. Essa cadeia de conexão é criada e gerenciada internamente. Não modifique-o. As cadeias de conexão inseridas são resolvidas pelo suplemento PowerPivot para Excel em estações de trabalho do cliente ou pelo PowerPivot para SharePoint em uma fazenda SharePoint.
Contexto do servidor local nos procedimentos armazenados do Analysis Services
Data Source=*, onde * se refere à instância local.
Criptografando cadeias de conexão
O Analysis Services criptografa e armazena as cadeias de conexão que usa para se conectar a cada uma de suas fontes de dados. Se a conexão com uma fonte de dados exigir um nome de usuário e senha, você poderá fazer com que o Analysis Services armazene o nome e a senha com a cadeia de conexão ou solicite o nome e a senha sempre que uma conexão com a fonte de dados for necessária. Fazer com que o Analysis Services solicite informações do usuário significa que essas informações não precisam ser armazenadas e criptografadas. No entanto, se você armazenar essas informações na cadeia de conexão, essas informações precisarão ser criptografadas e protegidas.
Para criptografar e proteger as informações da cadeia de conexão, o Analysis Services usa a API de Proteção de Dados. O Analysis Services usa uma chave de criptografia separada para criptografar informações de cadeia de conexão para cada banco de dados do Analysis Services. O Analysis Services cria essa chave quando você cria um banco de dados e criptografa informações de cadeia de conexão com base na conta de inicialização do Analysis Services. Quando o Analysis Services é iniciado, a chave criptografada para cada banco de dados é lida, descriptografada e armazenada. Em seguida, o Analysis Services usa a chave descriptografada apropriada para descriptografar as informações da cadeia de conexão da fonte de dados quando o Analysis Services precisa se conectar a uma fonte de dados.
Consulte Também
Configurar o acesso HTTP ao Analysis Services no IIS (Serviços de Informações da Internet) 8.0
Configurar o Analysis Services para delegação restrita de Kerberos
Provedores de dados usados para conexões do Analysis Services
Conectar-se ao Analysis Services