Propriedades de cadeia de conexão (Analysis Services)
Este tópico documenta as propriedades da cadeia de conexão que você pode definir em uma das ferramentas de designer ou de administração, ou que você pode ver nas cadeias de conexão criadas por aplicativos cliente que se conectam aos dados do Analysis Services ou os consultam. Sendo assim, ele aborda apenas um subconjunto das propriedades disponíveis. A lista completa inclui várias propriedades de servidor e de banco de dados, permitindo que você personalize a conexão de um aplicativo específico, independentemente de como a instância ou o banco de dados está configurado no servidor.
Os desenvolvedores que criam cadeias de conexão personalizadas no código do aplicativo devem examinar a documentação da API do cliente ADOMD.NET para exibir uma lista mais detalhada: ConnectionString
As propriedades descritas neste tópico são usadas pelas bibliotecas de cliente do Analysis Services, AMO, ADOMD.NET e provedor OLE DB do Analysis Services. A maioria das propriedades da cadeia de conexão pode ser usada com as três bibliotecas de cliente. As exceções são destacadas na descrição.
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ê define a mesma propriedade duas vezes por engano, a última propriedade da 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 Conectar-se de aplicativos cliente (Analysis Services).
Parâmetros de conexão de uso comum
A tabela a seguir descreve as propriedades mais usadas na criação de uma cadeia de conexão.
| Propriedade | Descrição | Exemplo |
|---|---|---|
Data Source ou DataSource |
Especifica a instância do servidor. Esta 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 for configurado para acesso HTTP ou HTTPS, ou o nome de um arquivo de cubo local (.cub). | Data source=AW-SRV01 para a instância padrão e a porta (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.Data source=172.16.254.1 para um endereço IP do servidor, ignorando a pesquisa de servidor DNS, útil para solucionar problemas de conexão. |
Initial Catalog ou Catalog |
Especifica o nome do banco de dados do Analysis Services que será o destino da conexão. O banco de dados deve ser implantado no Analysis Services, e você deve ter permissão para se conectar a ele. Esta propriedade é opcional para conexões do AMO, mas é obrigatória para o ADOMD.NET. | Initial catalog=AdventureWorks2012 |
Provider |
Os valores válidos incluem MSOLAP ou MSOLAP.<versão>, em que <a versão> é 3, 4 ou 5. No sistema de arquivos, o nome do provedor de dados é msolap110.dll para o SQL Server 2012, msolap100.dll para o SQL Server 2008 e 2008 R2, e msolap90.dll para o SQL Server 2005. A versão atual é MSOLAP.5. Essa 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 usa a versão atual e as versões anteriores do Analysis Services, é mais provável que você precise especificar qual provedor será usado nas cadeias de conexão criadas 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 download. Acesse Microsoft SQL Server 2012 Feature Pack para baixar o provedor OLE DB do Analysis Services para SQL Server 2012. O MSOLAP.4 era fornecido no SQL Server 2008 e no SQL Server 2008 R2. A versão 2008 R2 oferece suporte às pastas de trabalho PowerPivot e, às vezes, precisa ser instalada manualmente nos servidores do SharePoint. Para fazer a distinção entre essas versões, você deve verificar o número da compilação nas propriedades de arquivo do provedor: vá para Arquivos de Programas\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 de versão do arquivo. A versão deve incluir 10.50.<buildnumber> para SQL Server 2008 R2. Para saber mais, veja Instalar o Provedor OLE DB do Analysis Services em servidores do SharePoint e Provedores de dados usados para conexões do Analysis Services. MSOLAP.3 foi lançado em SQL Server 2005. MSOLAP.4 foi lançado em SQL Server 2008 e novamente SQL Server 2008 R2 MSOLAP.5 foi lançado em SQL Server 2012 |
Provider=MSOLAP.3 é usado em conexões que exigem o 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 nome do cubo ou 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 de uma perspectiva. |
Autenticação e segurança
Esta seção inclui as propriedades da cadeia de conexão relacionadas à autenticação e à criptografia. O Analysis Services usa apenas a Autenticação do Windows, mas você pode definir as propriedades da cadeia de conexão a serem passadas em um nome de usuário e uma 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 domínio\usuário. Para usar essa propriedade, o chamador deve ter permissões administrativas no Analysis Services. Para obter mais informações sobre o uso dessa propriedade em uma pasta de trabalho do Excel no SharePoint, consulte Usar o EffectiveUserName do Analysis Services no SharePoint Server 2013. Para obter uma ilustração que demonstre como essa propriedade é usada com o Reporting Services, consulte Usando EffectiveUserName para representar no SSAS.EffectiveUserName é usado em uma instalação do PowerPivot para SharePoint a fim de capturar informações de uso. A identidade de usuário é fornecida ao servidor para que os eventos ou erros que incluem a identidade do usuário podem ser registrados nos arquivos de log. No caso do PowerPivot, ela não é usada para fins de autorização. |
| Encrypt Password | Especifica se uma senha local 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 é vazio. Esse valor deve ser explicitamente definido 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 e o cliente não pode ser representado. 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 cliente. Representação: esse é o valor padrão. A identidade do cliente pode ser representada, mas somente quando a conexão é estabelecida, e não em cada chamada. Delegado: o processo do servidor pode representar o contexto de segurança do cliente enquanto atua em nome do cliente. O processo do servidor também pode fazer chamadas de saída para outros servidores ao atuar 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 em branco, 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 das conexões HTTP é em branco.Ao usar SSPI, ProtectionLevel deve ser definido da seguinte maneira: Connect, PktIntegrity ou PktPrivacy. |
Persist Encrypted |
Defina essa propriedade quando o aplicativo cliente exigir que o objeto da fonte de dados mantenha 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 definidas como True, as informações de segurança, como a identidade do usuário ou a senha especificada anteriormente na cadeia de conexão, poderão ser obtidas na conexão depois que ela for estabelecida. 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 realiza nenhuma autenticação nos dados enviados ao servidor.Connect. Conexões autenticadas. Realiza a autenticação somente quando o cliente estabelece uma relação com um servidor.PktIntegrity. Conexões criptografadas. Verifica se todos os dados serão recebidos do cliente e se eles não foram alterados em trânsito.PktPrivacy. Criptografia assinada, suporte apenas para XMLA. Verifica se todos os dados foram recebidos do cliente, se eles não foram alterados em trânsito, e protege a privacidade dos dados criptografando-os.Para obter mais informações, consulte Establishing Secure Connections in ADOMD.NET. |
Roles |
Especifique uma lista delimitada por vírgulas de funções predefinidas a serem conectadas a um servidor ou banco de dados usando as 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 nenhuma associação de função. Um administrador que usa essa propriedade se conecta usando as permissões transmitidas por essa função. Alguns comandos poderão apresentar falha se a função não tiver permissão suficiente. |
SSPI |
Especifica explicitamente qual pacote de segurança será usado para autenticação do cliente quando a Integrated Security for definida como SSPI. O SSPI oferece suporte a vários pacotes, mas você pode usar esta propriedade para especificar um pacote específico. Os valores válidos são Negotiate, Kerberos, NTLM e Usuário Anônimo. Se esta propriedade não for definida, todos os pacotes estarão disponíveis para a conexão. |
Use Encryption for Data |
Criptografa as transmissões de dados. Os valores válidos são True e False. |
User ID=...; Password= |
User ID e Password são usados juntos. O Analysis Services representa a identidade de usuário especificada através dessas credenciais. Em uma conexão do Analysis Services, a inserção das credenciais na linha de comando é usada apenas quando o servidor é configurado para acesso HTTP, e você especificou a autenticação Básica em vez da 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 local ou uma conta de usuário de domínio. Observe que User ID tem um espaço inserido. UserName (sem espaço) e UID são os outros alias possíveis para essa propriedade. O alias de Password é PWD. |
Parâmetros para fins especiais
Esta seção descreve o restante dos parâmetros da cadeia de conexão. Eles são usados para assegurar os comportamentos de conexão específicos necessários a 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 para monitorar eventos de rastreamento, especialmente quando você tem vários aplicativos que acessam os mesmos bancos de dados. Por exemplo, adicionar Nome do Aplicativo='teste' a uma cadeia de conexão faz com que 'test' apareça em um rastreamento de SQL Server Profiler, conforme mostrado na captura de tela a seguir: sspropinitAppName e AppName são os alias dessa propriedade. Para obter mais informações, consulte Usar o parâmetro Application Name ao conectar-se ao SQL Server. |
AutoSyncPeriod |
Define a frequência (em milissegundos) de sincronização do cache do cliente e do servidor. O ADOMD.NET fornece armazenamento em cache do cliente para os objetos mais usados que tenham uma sobrecarga mínima de memória. Isso ajuda a reduzir o número de viagens de ida e volta ao servidor. O padrão é 10000 milissegundos (ou 10 segundos). Quando definida como nula 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 Default ou UTF-8 (esses são equivalentes) e UTF-16 |
CompareCaseSensitiveStringFlags |
Ajusta comparações de cadeia de caracteres com diferenciação de maiúsculas e minúsculas em uma localidade especificada. Para obter mais informações sobre como definir essa propriedade, consulte Propriedade CompareCaseSensitiveStringFlags. |
Compression Level |
Se TransportCompression for XPRESS, você poderá definir o nível de compactação para controlar a quantidade de compactação. Os valores válidos estão entre 0 e 9, em que 0 representa o nível mínimo de compactação e 9, o nível máximo de compactação. Quanto maior o nível de compactação, menos satisfatório será o desempenho. O valor padrão é 0. |
Connect Timeout |
Determina a quantidade máxima de tempo (em segundos) em 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 encerrará a tentativa de se conectar e gerará um erro. |
MDX Compatibility |
O objetivo dessa propriedade é assegurar 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 para 1 para assegurar que os membros de espaço reservado em hierarquias desbalanceadas fiquem visíveis em uma Tabela Dinâmica. Os valores válidos são 0, 1 e 2. Os valores 0 e 1 expõem os membros de espaço reservado; o valor 2 não expõe. Se essa propriedade estiver vazia, o valor 0 será assumido. |
MDX Missing Member Mode=Error |
Indica se sentindo os membros ausentes são ignorados em instruções MDX. Os valores válidos são Default, Error e Ignore. Default usa um valor definido pelo servidor. Erro gera um erro quando um membro não existe. Ignore especifica que os valores ausentes devem ser ignorados. |
Optimize Response |
Um bitmask que indica quais das otimizações de resposta de consulta a seguir sã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 formato compactado (esse é o padrão), como XML bruto, ou em formato binário. O formato binário codifica os elementos e atributos XML, tornando-os menores. A compactação é um formato proprietário que reduz ainda mais o tamanho das solicitações e das respostas. Os formatos de compactação e binários são usados para acelerar as solicitações e respostas de transferências de dados. Você deve usar uma biblioteca de cliente na conexão se estiver usando o formato binário ou compactado. O provedor OLE DB pode formatar as solicitações e as 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 de servidor EnableBinaryXML e EnableCompression. |
Real Time Olap |
Defina esta propriedade de modo que ela ignore o armazenamento em cache, fazendo com que todas as partições escutem ativamente as notificações de consulta. Por padrão, essa propriedade não é definida. |
Safety Options |
Define o nível de segurança das ações e funções definidas pelo usuário. Os valores válidos são 0, 1 e 2. Em uma conexão do Excel, essa propriedade é Safety Options=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 e IncludeEmpty. Data significa que não serão permitidos cálculos. Calculated permite cálculos. IncludeEmpty permite cálculos e que sejam retornadas linhas vazias no resultado da consulta. |
Timeout |
Especifica quanto tempo (em milissegundos) a biblioteca de cliente esperará a conclusão de um comando antes de gerar um erro. |
Transport Compression |
Define como as comunicações de cliente e de servidor são compactadas, quando a compactação é especificada através da propriedade Protocol Format. Os valores válidos são Default, None, Compressed e gzip. Default significa que não há compactação para TCP ou gzip que não há compactação para HTTP. None indica que não será usada nenhuma compactação. Compressed usa a compactação XPRESS (SQL Server 2008 e posterior). gzip só é válido para conexões HTTP, em que a solicitação HTTP inclui Accept-Encoding=gzip. |
UseExistingFile |
Usado ao conectar-se a um cubo local. Essa propriedade especifica se o cubo local será substituído. Os valores válidos são True ou False. Se definido como True, o arquivo de cubo deve existir. O arquivo existente será o destino da conexão. Se for definido como False, o arquivo de cubo será substituído. |
VisualMode |
Defina essa propriedade para controlar como os membros serão agregados quando a segurança da dimensão for aplicada. No caso dos dados de cubo que todos podem ver, a agregação de todos os membros faz sentido porque todos os valores que contribuem para o total ficam visíveis. No entanto, se você filtrar ou restringir as dimensões com base na identidade do usuário, a exibição de um total com base em todos os membros (combinando valores restritos e permitidos em um único total) pode ser confusa ou mostrar mais informações do que devem ser reveladas. Para especificar como os membros serão agregados quando a segurança da dimensão for aplicada, você poderá definir essa propriedade como True para usar somente os valores permitidos na agregação ou como False para excluir os valores restritos do total. Quando definido na cadeia de conexão, esse valor se aplicará ao nível do cubo ou da perspectiva. Em um modelo, você pode controlar os 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, no qual as agregações incluem valores que ficam ocultos para o usuário. O valor 1 exclui os valores ocultos do total. Esse é o padrão para Excel. O valor 2 inclui valores ocultos no total. Esse é o valor padrão no servidor. Visual Total ou Default MDX Visual Mode é o alia dessa propriedade. |
Reservado para uso futuro
As propriedades a seguir são permitidas em uma cadeia de conexão, mas não funcionam 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 por Suporte da Microsoft).
Política de cache
Taxa do Cache
Taxa do Cache2
Limite Dinâmico de Depuração
Modo de depuração
Modo
Compatibilidade SQL
Usar 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ê pode usar uma cadeia de conexão como esta se estiver configurando uma conexão no Reporting Services.
Data source=<servername>; initial catalog=<databasename>
Cadeia de conexão no Excel
A cadeia de conexão padrão 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 MDX é sempre definido como 1. Embora você possa alterar o valor para a sessão atual, o Excel redefinirá a compatibilidade de MDX para 1 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 em 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 com suporte do Analysis Services. Com a exceção de conexões a bancos de dados PowerPivot, você pode especificar essas cadeias de conexão 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 (na porta padrão 2382), resolve 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", resolve a porta da instância nomeada "instance1" e, em seguida, abrirá a conexão com essa porta do Analysis Services.
Conexões de cubos locais (arquivos .cub)
Data Source=<path>, por exemplo, "Data Source=c:\temp\a.cub"
Conexões de http(s) para msmdpump.dll
Data Source=<URL>, onde a URL é o endereço HTTP ou HTTPS para a pasta IIS virtual 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 de http para pastas de trabalho PowerPivot (arquivos .xlsx, .xlsb ou .xlsm)
Data Source=<URL>, onde 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) com arquivos de Conexão do Modelo Semântico de BI
Data Source=<URL> em que a URL é o caminho do SharePoint até o arquivo .bism. Por exemplo, "Fonte de Dados=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 na pasta de trabalho. Esta cadeia de conexão é criada e gerenciada internamente. Não modifique-a. As cadeias de conexão inseridas são resolvidas pelo suplemento PowerPivot para Excel em estações de trabalho cliente ou por instâncias do PowerPivot para SharePoint em um farm do SharePoint.
Contexto de servidor local em procedimentos armazenados do Analysis Services
Data Source=*, em que * é resolvido como a 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 essas informações forem armazenadas na cadeia de conexão, será necessário criptografá-las e protegê-las.
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 em conexões do Analysis Services
Conectar ao Analysis Services