Propriedades de cadeia de conexão

Aplica-se a: Power BI Premium SQL Server Analysis Services Azure Analysis Services

Este artigo descreve as propriedades de cadeia de conexão usadas por aplicativos cliente que se conectam e consultam Azure Analysis Services (Azure AS), SQL Server Analysis Services (SSAS) e Power BI Premium dados do conjunto de dados. Essas propriedades são usadas pelas bibliotecas de clientes do Analysis Services, ADOMD.NET, AMO e MSOLAP (OLE DB) para o 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.

Use o seletor de versão acima do sumário à esquerda para ver apenas as propriedades que se aplicam a uma determinada plataforma ou versão.

Propriedades da conexão

fonte de dados

Especifica a instância do servidor. Esta propriedade é necessária para todas as conexões.

Os valores válidos para Azure Analysis Services incluem <protocol>://<region>/<servername> onde o protocolo é cadeia de caracteres asazure ou link ao usar um alias de nome de servidor, a região é o Uri em que o servidor foi criado (por exemplo, westus.asazure.windows.net) e o nome do servidor é o nome do servidor exclusivo dentro da região.

Exemplo Descrição
Data source=asazure://westus.asazure.windows.net/myasserver Azure Analysis Services.
Data source=link://friendlyname.salesapp.azurewebsites.net/ Azure Analysis Services usando alias de nome de servidor.

Os valores válidos para Power BI Premium incluem <protocol>://api.powerbi.com/v1.0/[tenant name]/[workspace name] onde o protocolo é cadeia de caracterespowerbi, Uri éapi.powerbi.com, nome do locatário é o nome do locatário da organização oumyorg, e o nome do workspace é o nome de um workspace atribuído a uma capacidade dedicada.

Exemplo Descrição
Data source=powerbi://api.powerbi.com/v1.0/contoso.com/Sales Workspace Power BI Premium workspace.

Os valores válidos para SQL Server Analysis Services incluem o nome de rede ou 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).

Exemplo Descrição
Data source=AW-SRV01 Instância e porta padrão do SSAS (TCP 2383).
Data source=AW-SRV01\Finance Instância nomeada do SSAS.
Data source=AW-SRV01:8081 Instância padrão do SSAS, porta especificada.
Data source=AW-SRV01.corp.Adventure-Works.com SSAS nome de domínio totalmente qualificado, instância e porta padrão.
Data source=172.16.254.1 Endereço IP SSAS do servidor, ignorando a pesquisa do servidor DNS. Útil para solucionar problemas de conexão.
Provedor

Essa propriedade é necessária na cadeia de conexão ao usar um provedor OLE DB como MSOLAP. Ele permite que você use um provedor independente de versão (geralmente o mais recente) como "Provider=MSOLAP" ou também pode especificar um provedor dependente de versão como "Provider=MSOLAP.7". Os valores dependentes de versão válidos seguem o padrão MSOLAP.< versão>, em que <a versão> é 7 ou 8. Por exemplo, MSOLAP.7 lançado no SQL Server 2016. A versão ".8" é a mais recente e considerada "evergreen". Espera-se que continue atualizando com a compatibilidade com versões anteriores mantida. Números de versão anteriores também são possíveis, mas essas versões do MSOLAP agora estão fora do suporte padrão.

Essa propriedade é opcional para ADOMD.NET e AMO. Ele é permitido para conveniência ao copiar uma cadeia de conexão MSOLAP para usar com ADOMD.NET e AMO.

Exemplo Descrição
Provider=MSOLAP.7 Conexões que exigem SQL Server versão 2016 do provedor OLE DB para Analysis Services.
Cubo

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.

Exemplo Descrição
Cube=Sales Um cubo chamado Sales.
Cube=SalesPerspective Uma perspectiva chamada SalesPerspective.

Propriedades de segurança e autenticação

Azure Analysis Services e Power BI Premium usam Azure Active Directory – Universal com MFA (recomendado), Azure Active Directory autenticação com nome de usuário e senha, Azure Active Directory tokens de acesso ou autenticação do Windows.

SQL Server Analysis Services usa apenas 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.

EffectiveUserName

Use quando uma identidade de usuário deve ser representada no servidor. Para SSAS, especifique em um formato de domínio\usuário. Para AS e Power BI Premium do Azure, especifique no formato UPN. Para usar essa propriedade, o chamador deve ter permissões administrativas no Analysis Services. Em Power BI Premium, o chamador deve ser um administrador do workspace em que o conjunto de dados está localizado.

CustomData

Um valor de cadeia de caracteres a ser passado para o mecanismo na cadeia de conexão e, em seguida, recuperado usando a função MDX CustomData() ou a função DAX CUSTOMDATA(). Mais comumente usado para passar uma userID ou nome de usuário como um valor e, em seguida, especificar esse valor na definição de uma expressão de segurança.

Criptografar Senha

Especifica se uma senha local será usada para criptografar cubos locais. Os valores válidos são True ou False. O padrão é False.

Senha de Criptografia

A senha usada para descriptografar um cubo local criptografado. O valor padrão é vazio. Esse valor deve ser explicitamente definido pelo usuário.

Nível de Representação

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 ao 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.
  • Representar. 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 ao atuar 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.
Segurança Integrada

A identidade do Windows do chamador é usada para se conectar ao Analysis Services. Os valores válidos são SSPI, blank, Basic e ClaimsToken*.

SSPI é o valor padrão para conexões TCP, permitindo a autenticação NTLM, Kerberos ou Anonymous. Para o AS do Azure e Power BI Premium SSPI indica a Tradução do AD. Ao usar o SSPI, a propriedade ProtectionLevel deve ser definida como Conexão, Integridade Pkt ou Privacidade Pkt.

em branco é o valor padrão para conexões HTTP.

*O ClaimsToken tem suporte para as Power BI Premium e AS do Azure.

Informações de Persistência de Segurança

Os valores válidos são True ou 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.

Nível de proteção

Determina o nível de segurança usado na conexão. Os valores com suporte dependem do transporte subjacente. 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.
  • Conexão. Conexões autenticadas. Realiza a autenticação somente quando o cliente estabelece uma relação com um servidor.
  • Integridade do pkt. Conexões criptografadas. Verifica se todos os dados serão recebidos do cliente e se eles não foram alterados em trânsito.
  • Privacidade do pkt. Criptografia assinada, com suporte apenas para TCP. 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 saber mais, confira Como estabelecer conexões seguras no ADOMD.NET

Funções

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. Definir a propriedade como um valor vazio, por exemplo, Roles=' ' significa que 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 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
  • Usuário Anônimo

Se esta propriedade não for definida, todos os pacotes estarão disponíveis para a conexão.

Usar Criptografia para Dados

Criptografa as transmissões de dados. Os valores válidos são True ou False.

ID do usuário=...; Password=

As propriedades ID do Usuário e Senha fornecem as credenciais apropriadas para o servidor quando o usuário ativo atual no aplicativo cliente não pode ser propagado automaticamente para o servidor. O comportamento depende do protocolo de transporte e do servidor que está sendo conectado a:

  • Ao se conectar por TCP ao SSAS, a biblioteca de clientes representará o usuário Windows usando o nome de usuário e a senha especificados e, em seguida, conectará como de costume ao servidor.
  • Ao se conectar via HTTP(S) ao SSAS, as credenciais são fornecidas ao servidor Web com base no modo de autenticação configurado no servidor Web, por exemplo, autenticação básica ou autenticação de Windows. O servidor Web executará a representação Windows apropriada antes de se conectar ao servidor SSAS, fornecendo, portanto, o fluxo de credenciais correto para o servidor.
  • Ao se conectar ao Azure AS ou Power BI Premium, a ID de Usuário e a Senha são usadas para obter um token de Azure Active Directory (AAD) que é apresentado ao serviço durante a autenticação. O AAD também pode exigir a MFA (autenticação multifator), que pode exigir interação adicional do usuário antes que o token possa ser gerado.
  • Se você já adquiriu um token de acesso válido do portador do AAD de seu próprio aplicativo, poderá omitir a propriedade ID do Usuário e especificar apenas o token de acesso na propriedade Password . A autenticação tem suporte para tokens de portador adquiridos interativamente para um usuário e usando o fluxo OAuth 2.0 em nome do usuário (por exemplo, um aplicativo Web de camada intermediária que se conecta ao Analysis Services em nome do usuário). Omita o tipo de token ao passar o token de acesso na propriedade Password. As bibliotecas de clientes do Analysis Services adicionam automaticamente o valor de esquema de autenticação "Portador" ao token de acesso.

Nota: A "ID do usuário" tem um espaço inserido. Um alias alternativo para ID de Usuário é UID e um alias alternativo para Senha é PWD.

Propriedades de finalidade especial

Essas propriedades são usadas para garantir comportamentos de conexão específicos exigidos por um aplicativo. As propriedades são listadas em ordem alfabética.

Nome do Aplicativo

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 o Nome do Aplicativo='test' a uma cadeia de conexão faz com que o 'teste' apareça em um rastreamento de SQL Server Profiler. Os aliases para essa propriedade incluem SspropInitAppName, AppName. Para saber mais, consulte o Nome do Aplicativo para conexões de SQL Server.

Período de Sincronização Automática

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.

Por motivos de desempenho, as bibliotecas de cliente armazenam em cache algumas informações do servidor, por exemplo, determinados conjuntos de linhas de esquema. O Período de Sincronização Automática permite que um usuário altere o período de tempo após o qual a biblioteca de clientes verifica com o servidor se os caches precisam ou não ser esvaziados. Em geral, você não deve precisar alterar o valor do padrão.

Codificação de Caracteres

Define como os caracteres são codificados na solicitação. Os valores válidos são Padrão ou UTF-8 (são equivalentes) e UTF-16.

CommitTimeout

Uma propriedade XMLA. Determina, em milissegundos, quanto tempo a fase de confirmação de um comando que está sendo executado no momento espera antes da reversão. Quando for maior que 0, substitui o valor da propriedade CommitTimeout correspondente na configuração do servidor.

CompareCaseSensitiveStringFlags

Ajusta comparações de cadeia de caracteres com diferenciação de maiúsculas e minúsculas em uma localidade especificada.

Nível de Compactação

Se TransportCompression for compactado, 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. 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 for bem-sucedida nesse período, o cliente deixará de tentar se conectar e gerará um erro.

DbpropMsmdRequestMemoryLimit

Substitui o valor da propriedade do servidor Memory\QueryMemoryLimit para uma conexão.

Especificada em quilobytes, essa propriedade pode reduzir a quantidade de memória usada durante uma consulta da memória máxima permitida (especificada como porcentagem) em QueryMemoryLimit. Ele não pode aumentar a quantidade de memória usada além da memória máxima permitida especificada em QueryMemoryLimit.

Modo visual MDX padrão

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 é 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.
  • 1 exclui valores ocultos do total. Esse é o padrão para Excel.
  • 2 inclui valores ocultos no total. Esse é o valor padrão no servidor.

O alias dessa propriedade é VisualMode.

Compatibilidade com MDX

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.

Modo membro ausente do MDX

Indica se sentindo os membros ausentes são ignorados em instruções MDX. Os valores válidos são Padrão, Erro e Ignorar. 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.

Otimizar a Resposta

Um bitmask que indica quais das otimizações de resposta de consulta a seguir são habilitadas.

  • 0x01 Usar o NormalTupleSet (padrão).
  • 0x02 Usar quando as segmentações estiverem vazias.
Tamanho do Pacote

Aplica-se somente a conexões TCP. Um tamanho de pacote de rede (em bytes) entre 512 e 32.767. O tamanho do pacote de rede padrão é 4096.

Formato de Protocolo

Define o formato do XML usado pelo protocolo de comunicação XMLA. Os valores válidos são Padrão, XML ou Binário. Você pode especificar que o XML seja enviado em um formato binário ou como XML de texto. O formato binário codifica os elementos e atributos XML, tornando-os menores. Além disso, a compactação também pode ser habilitada para que as mensagens reduzam o tamanho de solicitações e respostas usando a opção Compactação de Transporte. Solicitações e respostas podem usar formatos de protocolo diferentes, dependendo do que o cliente e o servidor dão suporte. Por exemplo, uma biblioteca de clientes só pode dar suporte a binários para respostas, mas não para solicitações, ou um servidor pode ter desabilitado binário para solicitações de entrada.

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 .

Olap em Tempo Real

Defina essa propriedade para ignorar o cache, fazendo com que todas as consultas de armazenamento busquem dados do sistema de origem. Por padrão, essa propriedade não é definida.

Opções de Segurança

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, 2. Em uma conexão 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 Dados, Calculados, 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.

Tempo limite

Especifica quanto tempo (em segundos) a biblioteca de cliente esperará a conclusão de um comando antes de gerar um erro.

Compactação de Transporte

Define como as comunicações de cliente e servidor são compactadas. Os valores válidos são Padrão, Nenhum, Compactado. Nenhum indica que nenhuma compactação é usada. Compactado usa compactação XPRESS.

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.

Confira também

Classes fundamentais amo – objetos de servidor
Classe AdomdConnection – Propriedades