Detalhes da Conexão Microsoft SSAS¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8361 do conector.

Começando¶

Suporte à versão do SQL Server Analysis Services

O conector envolve a complexidade da conexão com o SQL Server Analysis Services em um driver padrão: Autenticar com HTTP, Windows (NTLM) ou Kerberos. Você pode então executar consultas SQL-92 ou passar por consultas MDX de ferramentas relacionais.

Estabelecendo uma Conexão¶

Conectando-se ao SQL Server Analysis Services¶

Para conectar, defina o URL para um endpoint válido do SQL Server Analysis Services e fornecer autenticação. O conector deve se conectar a instâncias do SQL Server Analysis Services hospedadas por HTTP com acesso XMLA. Consulte a documentação da Microsoft para configurar o acesso HTTP para SQL Server Analysis Services.

Autenticação no SQL Server Analysis Services¶

O conector suporta os principais esquemas de autenticação, incluindo HTTP e Windows.

Definir AuthScheme para usar os seguintes tipos de autenticação.

Autenticação Anônima¶

Se a autenticação anônima estiver disponível, defina AuthScheme para nenhum para evitar a autenticação.

Autenticação Básica¶

Definir banco de dados SQL Server User e Password E definir AuthScheme para "BÁSICO".

Windows (ntlm)¶

Defina as Windows User e Password E definir AuthScheme para "NTLM".

Autenticação com Kerberos¶

Consulte Usando Kerberos para obter detalhes sobre como autenticar com Kerberos.

Protegendo Conexões do SQL Server Analysis Services¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema. Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis.

Usando Kerberos¶

Esta seção mostra como usar o conector para autenticar no SQL Server Analysis Services usando Kerberos.

Autenticação com Kerberos¶

Para autenticar no SQL Server Analysis Services usando Kerberos, defina as seguintes propriedades:

• AuthScheme: Defina para NEGOTIATE.
• KerberosKDC: Defina isso como host name or IP Address de sua máquina Kerberos KDC.
• KerberosRealm: Defina para the realm of the SQL Server Analysis Services Kerberos principal. Este será o valor após o símbolo '@' (por exemplo, EXAMPLE.COM) do principal value (por exemplo, ServiceName/MyHost@EXAMPLE.COM).
• KerberosSPN: Defina isso como service and host of the SQL Server Analysis Services Kerberos Principal. Este será o valor anterior ao símbolo '@' (por exemplo, ServiceName/MyHost) do principal value (por exemplo, ServiceName/MyHost@EXAMPLE.COM).

Recupere o Tíquete Kerberos¶

Você pode usar uma das opções a seguir para recuperar o tíquete Kerberos necessário.

Arquivo de Cache de Credenciais do MIT Kerberos¶

Esta opção permite que você use o MIT Kerberos Ticket Manager ou o comando kinit para obter tickets. Observe que você não precisa definir o User ou Password propriedades de conexão com esta opção.

1. Certifique-se de ter criado uma variável de ambiente chamada KRB5CCNAME.
2. Defina o KRB5CCNAME variável de ambiente para um caminho apontando para o seu credential cache file (por exemplo, C:\krb_cache\krb5cc_0 ou /tmp/krb5cc_0). Este arquivo será criado ao gerar seu ticket com o MIT Kerberos Ticket Manager.
3. Para obter um ticket, abra o aplicativo MIT Kerberos Ticket Manager, clique em Get Ticket, enter your principal name and password, then click OK. Se for bem-sucedido, as informações do tíquete aparecerão no Kerberos Ticket Manager e agora serão armazenadas no arquivo de cache de credenciais.
4. Agora que o arquivo de cache de credenciais foi criado, o conector usará o arquivo de cache para obter o tíquete Kerberos para se conectar ao SQL Server Analysis Services.

Como alternativa para definir o KRB5CCNAME variável de ambiente, você pode definir diretamente o caminho do arquivo usando KerberosTicketCache propriedade. Quando definido, o conector usará o arquivo de cache especificado para obter o tíquete Kerberos para se conectar ao SQL Server Analysis Services.

Arquivo Keytab¶

Se a variável de ambiente KRB5CCNAME não foi definida, você pode recuperar um tíquete Kerberos usando um Keytab File. Para fazer isso, defina o User propriedade para o nome de usuário desejado e defina o KerberosKeytabFile para um caminho de arquivo apontando para o arquivo keytab associado ao usuário.

Usuário e Senha¶

Se a variável de ambiente KRB5CCNAME e a propriedade KerberosKeytabFile não tiverem sido definidas, você pode recuperar um ticket usando um User and Password combination. Para fazer isso, defina o User e Password propriedades para a combinação de usuário/senha que você usa para autenticar com o SQL Server Analysis Services.

Autenticação Cross-Realm¶

Ambientes Kerberos mais complexos podem exigir autenticação cross-realm em que vários realms e servidores KDC são usados (por exemplo, onde um realm/KDC é usado para autenticação do usuário e outro realm/KDC usado para obter o tíquete de serviço).

Em tal ambiente, o KerberosRealm e KerberosKDC as propriedades podem ser definidas com os valores necessários para autenticação do usuário. O KerberosServiceRealm e KerberosServiceKDC as propriedades podem ser definidas com os valores necessários para obter o ticket de serviço.

Acesso a Dados de Ajuste Fino¶

Acesso a Dados de Ajuste Fino¶

Definir as seguintes outras propriedades também pode ser útil em determinadas situações:

• UseMDX: Indica se as consultas MDX estão sendo enviadas. Por padrão, isso é falso, o que fará com que o driver aceite apenas consultas compatíveis com SQL-92. Definir essa propriedade como true fará com que todas as consultas sejam passadas diretamente para o SQL Server Analysis Services.

• ExtraProperties: Propriedades adicionais a serem enviadas junto com uma consultar MDX. Apenas significativo se UseMDX é verdade.

• IncludeJoinColumns: Booleano indicando se devem ser adicionadas colunas extras usadas para fazer condições ON com junções. Eles não retornam com nenhum valor - eles são adicionados apenas para habilitar as ferramentas que os exigem para configurar automaticamente os relacionamentos entre as tabelas ao criar junções.

• ResponseRowLimit: Define um limite calculado no número de linhas para permitir que o usuário selecione antes de gerar um erro. Como as consultas estão sendo convertidas para MDX, selecionar apenas algumas colunas pode multiplicar exponencialmente o número de resultados esperados.

  Por este motivo, ResponseRowLimit está disponível para tentar fornecer algumas orientações sobre quais tipos de consultas provavelmente resultarão em um tempo limite. Pode ser desativado definindo como 0.

Recuperando Dados do Analysis Services¶

O SQL Server Analysis Services é um banco de dados OLAP que expõe dados como cubos, que você consultar com MDX (expressões multidimensionais). O conector modela esses cubos em exibições relacionais que você pode consultar com o SQL-92. O seguinte mapeamento é para o layout do modelo:

• Catalog - Exibido no conector como um Catálogo.
• Cube - Exibido no conector como um esquema.
• Measure - Disponível no conector na visualização Medidas especiais.
• Dimension - Cada dimensão é exposta como uma visualização.
• Level - Cada nível individual de uma hierarquia é exposto como uma coluna na exibição de dimensão apropriada.

Unindo Medidas e Dimensões¶

Para recuperar medidas por valor de nível específico, emita uma junção entre a visualização Medida e qualquer dimensão ou conjunto de dimensões. Por exemplo, emitir o seguinte recuperará o número de clientes em cada cidade:

select m.[Customer Count], c.[City]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Observe que não há nenhuma condição ON necessária. Isso ocorre porque as tabelas já estão relacionadas adequadamente no SQL Server Analysis Services. Se você estiver usando uma ferramenta que requer condições ON, defina IncludeJoinColumns para verdadeiro. Isso anexará várias colunas de chave estrangeira a cada exibição, que as relacionará umas com as outras. Essas colunas não retornarão dados por conta própria, mas podem ser selecionadas automaticamente com ferramentas para construir as condições ON para junções quando necessário.

Agregando Dados¶

Os dados armazenados no SQL Server Analysis Services já estão agregados. Em muitos casos, tentar recuperar um agregado pode ser sintaticamente equivalente a não especificar nada. Por exemplo, a consultar a seguir retornará exatamente os mesmos dados da anterior:

select Sum(m.[Customer Count]), c.[City]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m
GROUP BY c.[City]

A exceção a esta regra é quando uma agregação de resultados filtrados é solicitada. Nesses casos, um cálculo será solicitado do SQL Server Analysis Services. Por exemplo, para calcular a soma e a média dos clientes na França e na Alemanha:

select Sum(m.[Customer Count]), Avg(m.[Customer Count]), c.[Country]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m
WHERE c.[Country] IN ('France', 'Germany')
GROUP BY c.[Country]

Selecionando Múltiplas Hierarquias¶

No SQL Server Analysis Services, as dimensões individuais são compostas por hierarquias que podem ter um ou mais níveis. Por exemplo, a tabela AdventureWorks Customers tem City, Country e Gender. Cidade e País fazem parte da mesma hierarquia enquanto Gênero é sua própria hierarquia.

Ao selecionar várias hierarquias, o método para oferecer suporte a isso é unir os valores em MDX. Embora não seja óbvio a partir de um modelo de tabela relacional dos dados como o conector apresenta, isso pode resultar na execução de consultas muito caras. Por exemplo, executando o seguinte:

select c.[Country], m.[Customer Count]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Vai resultar em 6 linhas. No entanto, selecionando Gênero também:

select c.[Country], c.[Gender], m.[Customer Count]
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 
INNER JOIN [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Measures AS m

Agora resultará em 12 linhas. É porque Gênero e País estão em hierarquias diferentes, portanto, uma união cruzada é necessária para retornar os dois juntos. Cada hierarquia adicional adicionada ao SELECT multiplicará os resultados totais pelo número de valores disponíveis nessa hierarquia. Assim, para obter uma contagem de quantas linhas esperar, pode-se executar o seguinte:

select (Count(c.[Country])*Count(c.[Gender])) AS totalrows
FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer AS c 

Limite de Linha de Resposta¶

Devido à forma como a seleção de várias hierarquias multiplicará o número total de linhas de resultado, é possível aumentar o número de linhas de resposta muito rapidamente, o que resultará em tempos limite. Para tentar dar alguma visibilidade de quais consultas serão muito caras, o ResponseRowLimit a propriedade de conexão foi adicionada como um mecanismo para tentar orientar os usuários em melhores práticas. Quando definido, ele calculará quantas linhas esperar antes que qualquer consultar seja executada. Se o número de linhas previstas exceder o limite, um erro será lançado indicando quantas linhas esperar de volta com a consultar.

Recomenda-se selecionar apenas as colunas necessárias ou aplicar um critério WHERE. Ambos podem reduzir significativamente o número de linhas de resposta, o que terá um grande impacto no desempenho. Se você já está familiarizado com o conector e quais consultas podem ser caras, ResponseRowLimit pode ser desativado definindo-o como 0.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector do SQL Server Analysis Services.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visões definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Conector Jitterbit para SQL Server Analysis Services permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Esquema para Exibições Definidas pelo Usuário¶

Visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Resultando na consultar efetiva à fonte:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Certificados SSL do Cliente¶

O conector do SQL Server Analysis Services também dá suporte à configuração de certificados de cliente. Defina o seguinte para se conectar usando um certificado de cliente.

• SSLClientCert: O nome do armazenamento de certificados para o certificado do cliente.
• SSLClientCertType: O tipo de armazenamento de chaves que contém o certificado de cliente TLS/SSL.
• SSLClientCertPassword: A senha para o certificado do cliente TLS/SSL.
• SSLClientCertSubject: O assunto do certificado de cliente TLS/SSL.

Modelo de Dados¶

SQL Server Analysis Services é um banco de dados OLAP que expõe dados como cubos, que você consultar com MDX (expressões multidimensionais). O conector modela esses cubos em exibições relacionais que você pode consultar com SQL-92 ou MDX.

Acessando cubos como visualizações

O SQL Server Analysis Services é fundamentalmente diferente de um banco de dados relacional; refletindo essas diferenças, o Conector Jitterbit para SQL Server Analysis Services não oferece suporte a muitos recursos SQL-92 encontrados em um driver para um RDBMS. Para ignorar quaisquer limitações com tradução de consultar, você pode enviar consultas MDX de passagem do conector.

Consulte Recuperando Dados do Analysis Services para obter limitações de consultar e mais informações sobre como consultar o SQL Server Analysis Services.

Modelagem de visualizações dinamicamente

Você pode consultar todos os cubos em sua instância do SQL Server Analysis Services; quando você se conecta, o conector recupera os metadados do SQL Server Analysis Services e exibe as dimensões e medidas disponíveis como colunas para as exibições (cubos). O conector atualiza dinamicamente os esquemas nas conexões subsequentes.

Atributos de medida

Por padrão, todos os atributos de medida são listados em uma exibição 'Medidas'. No entanto, você pode definir SplitMeasures para verdadeiro para dividir a exibição 'Medidas' e cada atributo de medida será incluído em sua respectiva exibição com base no valor do Grupo de medidas. Outras classificações baseadas em 'Diretórios de Medidas' não serão incluídas.

Acessando informações do esquema

Consulte as Tabelas do sistema para acessar informações de esquema e outros metadados do conector.

Tabelas do Sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema¶

As tabelas a seguir retornam metadados de banco de dados para SQL Server Analysis Services:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de Fonte de Dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

Sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

Sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

Sys_tablecolumns¶

Descreve as colunas das tabelas e exibições disponíveis.

A consultar a seguir retorna as colunas e os tipos de dados para a tabela [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer:

SELECT ColumnName, DataTypeName FROM sys_tablecolumns WHERE TableName='Customer' AND CatalogName='AdventureWorksDW2012Multidimensional-SE' AND SchemaName='Adventure Works'

Colunas¶

Sys_procedures¶

Lista os procedimentos armazenados disponíveis.

A consultar a seguir recupera os procedimentos armazenados disponíveis:

SELECT * FROM sys_procedures

Colunas¶

Sys_procedureparameters¶

Descreve procedimento armazenado* parâmetros.

A consultar a seguir retorna informações sobre todos os parâmetros de entrada para o procedimento armazenado SelectEntries:

SELECT * FROM sys_procedureparameters WHERE ProcedureName='SelectEntries' AND Direction=1 OR Direction=2

Colunas¶

Sys_keycolumns¶

Descreve as chaves primárias e estrangeiras. A consultar a seguir recupera a chave primária da tabela [AdventureWorksDW2012Multidimensional-SE].[Adventure Works].Customer:

SELECT * FROM sys_keycolumns WHERE IsKey='True' AND TableName='Customer' AND CatalogName='AdventureWorksDW2012Multidimensional-SE' AND SchemaName='Adventure Works'

Colunas¶

Sys_foreignkeys¶

Descreve as chaves estrangeiras. A consultar a seguir recupera todas as chaves estrangeiras que se referem a outras tabelas:

SELECT * FROM sys_foreignkeys WHERE ForeignKeyType = 'FOREIGNKEY_TYPE_IMPORT'

Colunas¶

Sys_indexes¶

Descreve os índices disponíveis. Ao filtrar por índices, você pode escrever consultas mais seletivas com tempos de resposta de consultar mais rápidos.

A consultar a seguir recupera todos os índices que não são chaves primárias:

SELECT * FROM sys_indexes WHERE IsPrimary='false'

Colunas¶

Sys_connection_props¶

Retorna informações sobre as propriedades de conexão disponíveis e as definidas na string de conexão.

Ao consultar esta tabela, a string de conexão de configuração deve ser usada:

jdbc:cdata:ssas:config:

Esta string de conexão permite que você consultar esta tabela sem uma conexão válida.

A consultar a seguir recupera todas as propriedades de conexão que foram definidas na string de conexão ou definidas por meio de um valor padrão:

SELECT * FROM sys_connection_props WHERE Value <> ''

Colunas¶

Sys_sqlinfo¶

Descreve o processamento da consultar SELECT que o conector pode transferir para a fonte de dados.

Processamento de Consultas Colaborativas¶

Ao trabalhar com fontes de dados que não suportam SQL-92, você pode consultar a exibição sys_sqlinfo para determinar os recursos de consultar das APIs subjacentes, expressas na sintaxe SQL. O conector transfere o máximo possível do processamento da instrução SELECT para o servidor e, em seguida, processa o restante da consultar na memória.

Descobrindo os Recursos SELECT da Fonte de Dados¶

Abaixo está um exemplo de conjunto de dados de recursos SQL. O conjunto de resultados a seguir indica a funcionalidade SELECT que o conector pode descarregar para a fonte de dados ou processar o lado do cliente. Sua fonte de dados pode suportar sintaxe SQL adicional. Alguns aspectos da funcionalidade SELECT são retornados em uma lista separada por vírgulas, se suportados; caso contrário, a coluna contém NO.

A consultar a seguir recupera os operadores que podem ser usados na cláusula WHERE:

SELECT * FROM sys_sqlinfo WHERE Name='SUPPORTED_OPERATORS'

Observe que tabelas individuais podem ter diferentes limitações ou requisitos na cláusula WHERE; consulte o Modelo de Dados para obter mais informações.

Colunas¶

Sys_identity¶

Retorna informações sobre tentativas de modificação.

A consultar a seguir recupera os IDs das linhas modificadas em uma operação em lote:

SELECT * FROM sys_identity

Colunas¶

Propriedades de Configurações Avançadas¶

As propriedades de configurações avançadas são as várias opções que podem ser usadas para estabelecer uma conexão. Esta seção fornece uma lista completa das opções que você pode configurar. Clique nos links para mais detalhes.

Autenticação

Kerberos

SSL

Esquema

Diversos

Autenticação¶

Esta seção fornece uma lista completa de propriedades de autenticação que você pode configurar.

AuthScheme¶

O esquema usado para autenticação. As entradas aceitas são NTLM, Basic, Digest, None e Negotiate.

Valores Possíveis¶

NTLM, Basic, Digest, None, Negotiate

Tipo de Dados¶

string

Valor Padrão¶

"NTLM"

Observações¶

Juntamente com Senha e Usuário, esse campo é usado para autenticar no servidor. NTLM é a opção padrão. Use as seguintes opções para selecionar seu esquema de autenticação:

• NTLM: Defina isso para usar suas credenciais do Windows para autenticar.
• Básico: Defina para usar a autenticação HTTP básica.
• Negociar: Se AuthScheme for definido como Negociar, o conector negociará um mecanismo de autenticação com o servidor. Definir AuthScheme para negociar o uso da autenticação Kerberos.
• Digest: Defina para usar a autenticação HTTP Digest.

URL¶

A URL usada para conectar-se ao SQL Server Analysis Services.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

A URL HTTP ou HTTPS usada para conectar-se ao SQL Server Analysis Services.

O conector deve se conectar a instâncias do SQL Server Analysis Services hospedadas por HTTP com acesso XMLA. Consulte a documentação da Microsoft para configurar o acesso HTTP para o SQL Server Analysis Services.

Do Utilizador¶

A conta de usuário do SQL Server Analysis Services usada para autenticação.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Juntamente com Senha, esse campo é usado para autenticação no servidor SQL Server Analysis Services.

Senha¶

A senha usada para autenticar o usuário.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O usuário e Password são usados juntos para autenticar com o servidor.

Kerberos¶

Esta seção fornece uma lista completa das propriedades do Kerberos que você pode configurar.

KerberosKDCName¶

O serviço Kerberos Key Distribution Center (KDC) usado para autenticar o usuário.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

As propriedades Kerberos são usadas ao usar SPNEGO ou Autenticação do Windows. O conector solicitará tíquetes de sessão e chaves de sessão temporárias do serviço Kerberos KDC. O serviço Kerberos KDC é colocado convencionalmente com o controlador de domínio.

Se o Kerberos KDC não for especificado, o conector tentará detectar essas propriedades automaticamente nos seguintes locais:

• KRB5 Config File (krb5.ini/krb5.conf): Se a variável de ambiente KRB5_CONFIG estiver definida e o arquivo existir, o conector obterá o KDC do arquivo especificado. Caso contrário, ele tentará ler a partir do local padrão do MIT com base no sistema operacional: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) ou /etc/krb5.conf (Linux)
• Java System Properties: Usando as propriedades do sistema java.security.krb5.realm e java.security.krb5.kdc.
• Domain Name and Host: O conector inferirá o Kerberos Realm e Kerberos KDC do nome de domínio configurado e do hospedar como último recurso.

Observação: A autenticação do Windows é suportada apenas no JRE 1.6 e superior.

KerberosRealmName¶

O Kerberos Realm usado para autenticar o usuário.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

As propriedades Kerberos são usadas ao usar SPNEGO ou Autenticação do Windows. O Kerberos Realm é usado para autenticar o usuário com o Kerberos Key Distribution Service (KDC). O Kerberos Realm pode ser configurado por um administrador para ser qualquer string, mas convencionalmente é baseado no nome de domínio.

Se Kerberos Realm não for especificado, o conector tentará detectar essas propriedades automaticamente nos seguintes locais:

• KRB5 Config File (krb5.ini/krb5.conf): Se a variável de ambiente KRB5_CONFIG estiver definida e o arquivo existir, o conector obterá o domínio padrão do arquivo especificado. Caso contrário, ele tentará ler a partir do local padrão do MIT com base no sistema operacional: C:\ProgramData\MIT\Kerberos5\krb5.ini (Windows) ou /etc/krb5.conf (Linux)
• Java System Properties: Usando as propriedades do sistema java.security.krb5.realm e java.security.krb5.kdc.
• Domain Name and Host: O conector inferirá o Kerberos Realm e o Kerberos KDC do nome de domínio configurado pelo usuário e do hospedar como último recurso. Isso pode funcionar em alguns ambientes Windows.

Observação: A autenticação baseada em Kerberos é suportada apenas no JRE 1.6 e superior.

KerberosSPN¶

O nome principal do serviço (SPN) para o controlador de domínio Kerberos.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Se o SPN no controlador de domínio Kerberos não for igual ao URL para o qual você está se autenticando, use esta propriedade para definir o SPN.

KerberosKeytabFile¶

O arquivo Keytab contendo seus pares de principais Kerberos e chaves criptografadas.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O arquivo Keytab contendo seus pares de principais Kerberos e chaves criptografadas.

SSL¶

Esta seção fornece uma lista completa de propriedades SSL que você pode configurar.

SSLClientCert¶

O armazenamento de certificados de cliente TLS/SSL para autenticação de cliente SSL (SSL bidirecional).

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

O nome do armazenamento de certificados para o certificado do cliente.

O SSLClientCertType campo especifica o tipo de armazenamento de certificado especificado por SSLClientCert. Se o armazenamento estiver protegido por senha, especifique a senha em SSLClientCertPassword.

SSLClientCert é usado em conjunto com o SSLClientCertSubject para especificar os certificados do cliente. Se SSLClientCert tem um valor e SSLClientCertSubject for definido, uma pesquisa por um certificado será iniciada. Consulte SSLClientCertSubject Para maiores informações.

As designações de armazenamentos de certificados dependem da plataforma.

A seguir estão as designações dos armazenamentos de certificados de Usuário e Máquina mais comuns no Windows:

Em Java, o armazenamento de certificados normalmente é um arquivo contendo certificados e chaves privadas opcionais.

Quando o tipo de armazenamento de certificado for PFXFile, essa propriedade deverá ser configurada para o nome do arquivo. Quando o tipo é PFXBlob, a propriedade deve ser configurada para o conteúdo binário de um arquivo PFX (por exemplo, armazenamento de certificados PKCS12).

SSLClientCertType¶

O tipo de armazenamento de chaves que contém o certificado do cliente TLS/SSL.

Valores Possíveis¶

USER, MACHINE, PFXFILE, PFXBLOB, JKSFILE, JKSBLOB, PEMKEY_FILE, PEMKEY_BLOB, PUBLIC_KEY_FILE, PUBLIC_KEY_BLOB, SSHPUBLIC_KEY_FILE, SSHPUBLIC_KEY_BLOB, P7BFILE, PPKFILE, XMLFILE, XMLBLOB

Tipo de Dados¶

string

Valor Padrão¶

"USER"

Observações¶

Esta propriedade pode assumir um dos seguintes valores:

SSLClientCertPassword¶

A senha para o certificado de cliente TLS/SSL.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Se o armazenamento de certificados for de um tipo que requer uma senha, essa propriedade será usada para especificar essa senha para abrir o armazenamento de certificados.

SSLClientCertSubject¶

O assunto do certificado de cliente TLS/SSL.

Tipo de Dados¶

string

Valor Padrão¶

"\*"

Observações¶

Ao carregar um certificado, o assunto é usado para localizar o certificado na loja.

Se uma correspondência exata não for encontrada, a loja é pesquisada em busca de assuntos que contenham o valor da propriedade. Se uma correspondência ainda não for encontrada, a propriedade será definida como uma string vazia e nenhum certificado será selecionado.

O valor especial "*" seleciona o primeiro certificado no armazenamento de certificados.

O assunto do certificado é uma lista separada por vírgulas de campos e valores de nomes distintos. Por exemplo, "CN=www.server.com, OU=test, C=US, E=support@company.com". Os campos comuns e seus significados são mostrados abaixo.

Se um valor de campo contiver uma vírgula, ela deverá ser colocada entre aspas.

SSLServerCert¶

O certificado a ser aceito do servidor ao conectar usando TLS/SSL.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Se estiver usando uma conexão TLS/SSL, esta propriedade pode ser usada para especificar o certificado TLS/SSL a ser aceito do servidor. Qualquer outro certificado que não seja confiável para a máquina é rejeitado.

Esta propriedade pode assumir as seguintes formas:

Se não for especificado, qualquer certificado confiável pela máquina será aceito.

Os certificados são validados como confiáveis pela máquina com base no armazenamento confiável do sistema. O armazenamento confiável usado é o valor 'javax.net.ssl.trustStore' especificado para o sistema. Se nenhum valor for especificado para esta propriedade, o armazenamento confiável padrão do Java será usado (por exemplo, JAVA_HOME\lib\security\cacerts).

Use '*' para indicar a aceitação de todos os certificados. Observe que isso não é recomendado devido a questões de segurança.

Esquema¶

Esta seção fornece uma lista completa de propriedades de esquema que você pode configurar.

Localização¶

Um caminho para o diretório que contém os arquivos de esquema que definem tabelas, exibições e procedimentos armazenados.

Tipo de Dados¶

string

Valor Padrão¶

"%APPDATA%\\\SSAS Data Provider\\Schema"

Observações¶

O caminho para um diretório que contém os arquivos de esquema para o conector (arquivos .rsd para tabelas e exibições, arquivos .rsb para procedimentos armazenados). A localização da pasta pode ser um caminho relativo a partir da localização do executável. O Location a propriedade só é necessária se você quiser personalizar definições (por exemplo, alterar um nome de coluna, ignorar uma coluna e assim por diante) ou estender o modelo de dados com novas tabelas, exibições ou procedimentos armazenados.

Se não for especificado, o local padrão é "%APPDATA%\\SSAS Data Provider\Schema" com %APPDATA% sendo definido para o diretório de configuração do usuário:

Esquemas Navegáveis¶

Essa propriedade restringe os esquemas relatados a um subconjunto dos esquemas disponíveis. Por exemplo, BrowsableSchemas=SchemaA,SchemaB,SchemaC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar os esquemas de bancos de dados pode ser caro. Fornecer uma lista de esquemas na string de conexão melhora o desempenho.

Tabelas¶

Esta propriedade restringe as tabelas reportadas a um subconjunto das tabelas disponíveis. Por exemplo, Tables=TableA,TableB,TableC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar as tabelas de alguns bancos de dados pode ser caro. Fornecer uma lista de tabelas na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as tabelas que deseja em uma lista separada por vírgulas. Cada tabela deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Tables=TableA,[TableB/WithSlash],WithCatalog.WithSchema.`TableC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Visualizações¶

Restringe as visualizações relatadas a um subconjunto das tabelas disponíveis. Por exemplo, Views=ViewA,ViewB,ViewC.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Listar as exibições de alguns bancos de dados pode ser caro. Fornecer uma lista de exibições na string de conexão melhora o desempenho do conector.

Essa propriedade também pode ser usada como uma alternativa para listar automaticamente as exibições se você já souber com quais deseja trabalhar e, caso contrário, haveria muitos para trabalhar.

Especifique as exibições desejadas em uma lista separada por vírgulas. Cada exibição deve ser um identificador SQL válido com quaisquer caracteres especiais escapados usando colchetes, aspas duplas ou acentos graves. Por exemplo, Views=ViewA,[ViewB/WithSlash],WithCatalog.WithSchema.`ViewC With Space`.

Observe que, ao conectar-se a uma fonte de dados com vários esquemas ou catálogos, você precisará fornecer o nome totalmente qualificado da tabela nesta propriedade, como no último exemplo aqui, para evitar ambigüidade entre tabelas que existem em vários catálogos ou esquemas.

Diversos¶

Esta seção fornece uma lista completa de diversas propriedades que você pode configurar.

Catálogo¶

O catálogo do Analysis Services a ser usado. Isso também pode ser conhecido como um banco de dados no Analysis Services.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Esta entrada é opcional, pois os catálogos serão exibidos por padrão. No entanto, se você tiver UseMDX definido como true, esse valor garantirá que as consultas MDX sejam enviadas ao catálogo correto.

CustomHeaders¶

Outros cabeçalhos conforme determinado pelo usuário (opcional).

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Essa propriedade pode ser definida como uma sequência de cabeçalhos a serem anexados aos cabeçalhos de solicitação HTTP criados a partir de outras propriedades, como ContentType, From e assim por diante.

Os cabeçalhos devem estar no formato "cabeçalho: valor" conforme descrito nas especificações do HTTP. As linhas de cabeçalho devem ser separadas pelos caracteres de retorno de carro e alimentação de linha (CRLF).

Use esta propriedade com cuidado. Se esta propriedade contiver cabeçalhos inválidos, as solicitações HTTP poderão falhar.

Essa propriedade é útil para ajustar a funcionalidade do conector para integração com APIs especializadas ou fora do padrão.

Propriedades Extras¶

Propriedades adicionais a serem enviadas em cada solicitação MDX ao SQL Server Analysis Services.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

Ao definir UseMDX como true, as propriedades podem ser especificadas usando essa propriedade de conexão para preencher valores extras na PropertiesList da solicitação XMLA. Use pares nome=valor separados por ponto e vírgula para enviar as propriedades. Por exemplo, Catalog=MyCatalog;Cube=MyCube;.

Uma lista de propriedades pode ser encontrada executando SELECT * FROM $System.DISCOVER_PROPERTIES.

IncludeJoinColumns¶

Defina como true para incluir colunas de junção extras em cada tabela.

Tipo de Dados¶

bool

Valor Padrão¶

false

Observações¶

Algumas ferramentas podem exigir uma condição ON (ou gerá-las automaticamente) com base em referências de chaves estrangeiras. Definindo IncludeJoinColumns para verdadeiro, toda tabela incluirá uma referência de chave estrangeira para as outras tabelas. Essas colunas não retornarão nenhum dado e não são úteis para nada além de passar como condições ON para realizar junções.

No SQL Server Analysis Services, as dimensões e medidas que compõem as tabelas já se relacionam naturalmente. Não há nenhum contexto para uni-los. Portanto, o Conector Jitterbit para SQL Server Analysis Services dá suporte à associação sem especificar uma condição ON, portanto, sua especificação é opcional.

MaxRows¶

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Tipo de Dados¶

int

Valor Padrão¶

-1

Observações¶

Limita o número de linhas retornadas quando nenhuma agregação ou agrupamento é usado na consultar. Isso ajuda a evitar problemas de desempenho em tempo de design.

Outro¶

Essas propriedades ocultas são usadas apenas em casos de uso específicos.

Tipo de Dados¶

string

Valor Padrão¶

""

Observações¶

As propriedades listadas abaixo estão disponíveis para casos de uso específicos. Os casos de uso e a funcionalidade normais do driver não devem exigir essas propriedades.

Especifique várias propriedades em uma lista separada por ponto e vírgula.

Integração e Formatação¶

ResponseRowLimit¶

O número de linhas de resposta a serem permitidas antes do erro. Defina como 0 para nenhum limite.

Tipo de Dados¶

int

Valor Padrão¶

100000

Observações¶

A seleção de muitas colunas resulta em várias junções cruzadas ocorrendo sob o capô quando convertidas para algo aceitável para o SQL Server Analysis Services. Isso não é intuitivo se você não estiver familiarizado com o MDX. Isso pode facilmente resultar em respostas muito grandes que expiram. O ResponseRowLimit é projetado para tentar alertar o usuário para entender quais solicitações podem ser muito caras.

SplitMeasures¶

Defina como true para dividir a tabela de medidas em tabelas individuais.

Tipo de Dados¶

bool

Valor Padrão¶

false

Observações¶

Todas as medidas estão atualmente agrupadas em uma única tabela 'Medidas'. Defina como true para dividir a tabela de medidas em tabelas individuais (se uma tabela contiver apenas medidas) e incluir medidas nas respectivas tabelas de dimensões.

Tempo Esgotado¶

O valor em segundos até que o erro de timeout seja lançado, cancelando a operação.

Tipo de Dados¶

int

Valor Padrão¶

60

Observações¶

Se Timeout = 0, as operações não expiram. As operações são executadas até serem concluídas com êxito ou até encontrarem uma condição de erro.

Se Timeout expira e a operação ainda não está concluída, o conector lança uma exceção.

Usar MDX¶

Defina como true para passar consultas MDX para SQL Server Analysis Services como estão.

Tipo de Dados¶

bool

Valor Padrão¶

false

Observações¶

Você pode executar consultas SQL-92 SELECT para as exibições modeladas pelo conector; defina essa propriedade para executar consultas MDX diretamente no SQL Server Analysis Services. Se você estiver usando consultas MDX diretamente, é recomendável especificar também o Catalog para garantir que as consultas MDX sejam enviadas ao catálogo correto.

Consulte Recuperando Dados do Analysis Services para obter mais informações sobre como consultar o SQL Server Analysis Services por meio do conector.