IBM Cognos Analytics configuração da linhagem

Para importar metadados de linhagem de IBM Cognos Analytics, crie uma conexão, uma definição de fonte de dados e um trabalho de importação de metadados.

O Cognos Analytics é uma plataforma de inteligência de negócios alimentada por IA que suporta o ciclo de análise inteiro, da descoberta à operacionalização.

Versões suportadas

Cognos Analytics 12

Metadados processados

Os seguintes metadados do Cognos Analytics são processados e exibidos no Lineage:

Relatórios e relatórios interativos, incluindo consultas em SQL
Modelos do Framework Manager
Projetos de cubos dinâmicos, incluindo cubos virtuais
Módulos de dados, conjuntos de dados, arquivos enviados
Conexões de Banco de Dados
Painéis

Limitações

Os seguintes dados não são processados:

Cubos dinâmicos criados no Framework Manager como parte de um pacote DQM
Fontes de dados baseadas nos cubos do Power e do TM1. Cognos Finance, Cognos Atualmente, e Cognos as fontes de dados de planejamento nem sequer são compatíveis com o próprio Cognos Analytics, conforme 11.0.4.
Histórias
Relatórios que utilizam muitas macros de consulta avançadas e prompts podem não ser precisos, pois utilizam informações de tempo de execução que o Automatic Data Lineage não consegue analisar
Relações entre pacotes no Framework Manager (que causam a falta de linhagem indireta)
Painéis com widgets complexos
Relatórios e painéis multilíngues

Configuração pré-requisita

Antes de importar metadados de linhagem, certifique-se de que os seguintes pré-requisitos estejam atendidos:

Você deve ter a função de Administrador de Diretório com permissão de LEITURA para garantir que todos os relatórios estejam disponíveis para extração.

Criação de um recurso de importação de metadados

Conexão da origem de dados

Para se conectar à fonte de dados da qual você deseja importar metadados de linhagem, é necessário selecionar uma definição de fonte de dados e uma conexão. Você pode criá-los antes de iniciar a importação de metadados ou ao criar e configurar o recurso de importação de metadados.

Definição de origem de dados

Se sua instância do Cognos Analytics estiver na mesma instância que IBM Cloud, use a definição da fonte de dados IBM Cloud, caso ela já tenha sido criada. Você pode usá-lo para todas as tecnologias do IBM que estiverem implantadas na sua instância do IBM Cloud. No gráfico de linhagem, os dados importados dessas instâncias do Cognos Analytics e de outras tecnologias são exibidos no contêiner “ IBM Cloud ”.

Em outros casos, selecione “ Cognos Analytics ” como tipo de fonte de dados.

Conexão

Ao importar metadados de linhagem, utilize apenas as conexões para as quais o recurso “ SSL ” estiver configurado.

Configure a conexão com as seguintes propriedades:

URL do gateway: Obrigatório. Especifique um gateway URL para se conectar a Cognos Analytics.
Tipo de implementação: Obrigatório. Especifique o tipo de ambiente em que a instância de destino do Cognos Analytics está implantada.
URL de token IAM: Opcional. Use esta opção apenas se estiver conectando-se a ambientes de desenvolvimento ou teste, ou outros ambientes que estejam usando IAM personalizado. Especifique um endereço completo URL para um ponto de extremidade usado para gerar tokens IAM. Esta opção é aplicável para tipos de implantação em nuvem.
Método de autenticação: Obrigatório. Especifique o método de autenticação para a conexão com a instância do Cognos Analytics. Os métodos de chave de API anônima e Cognos Analytics não são suportados.

Para obter detalhes sobre a conexão, consulte a conexão Cognos Analytics.

Modo de conexão

Você pode se conectar ao Cognos Analytics usando um dos seguintes modos de conexão:

Conexão direta
Conexão remota com um agente Manta. Quando um agente estiver configurado, selecione-o na lista. Para obter mais informações, consulte Configurando agentes para importação de metadados de linhagem.

Listas de inclusão e exclusão

É possível incluir ou excluir ativos até o nível do relatório. Os ativos que forem incluídos posteriormente na origem de dados também serão incluídos ou excluídos se corresponderem às condições especificadas nas listas.

Valores de exemplo:

Sales.*/MyReport: todos os relatórios com o nome MyReport que estejam em qualquer pasta com um nome que comece com Sales. Quando você cola o valor do caminho, uma barra à esquerda (/) pode ser adicionada. Remova a barra inicial conforme mostrado no exemplo.

Entradas externas

Você pode fornecer arquivos de projeto Cognos exportados como entrada externa.

Esta é uma estrutura de exemplo de um arquivo de projeto extraído do Cognos :

cubeProject - A folder with dynamic cubes.
   searchPathMappingManual.csv
   [dynamic_cube_project_file].fmd
dataSet - A folder with datasets.
    <cognos_namespace>
      <user>
       <exact folder hierarchy under user root folder>
         [dataset_file].xml
    team content
     <exact folder hierarchy under content root folder>
         [dataset_file].xml
dataSourceConnection - A folder with data source connections.
    <datasource_name> - A folder with data source connections for a single data source.
      [datasource_connection_name].txt
model - A folder with models.
   <cognos_namespace>
    <user>
      <exact folder hierarchy under user root folder>
        [model_file].xml
    team content
      <exact folder hierarchy under content root folder>
        [model_file].xml
module - A folder with modules.
    <cognos_namespace>
    <user>
      <exact folder hierarchy under user root folder>
       [module_file].xml
   team content
      <exact folder hierarchy under content root folder>
       [module_file].xml
report - A folder containing reports
    <cognos_namespace>
      <user>
        <exact folder hierarchy under user root folder>
          [report_name].xml
   team content
      <exact folder hierarchy under content root folder>
        [report_name].xml
localeMapping.xml - An XML file with mapping of objects between different locales.

Você também pode adicionar os seguintes arquivos de entrada:

Cubos dinâmicos - Esse arquivo contém cubos dinâmicos extraídos manualmente do site Cognos Analytics.
searchPathMappingManual.csv - Este arquivo CSV contém mapeamentos entre caminhos de pesquisa de relatórios e cubos dinâmicos.

Opções de importação avançadas

Identificador do código de idioma primário: Especifique o identificador da localidade do idioma principal em que seus objetos são exibidos, por exemplo, "en" para inglês, "de" para alemão etc. Se nenhum valor for fornecido, será usada a localidade da conta do usuário.
Identificadores de outros códigos de idioma: Especifique uma lista separada por vírgulas de identificadores de todos os idiomas locais usados em seu ambiente Cognos Analytics, exceto o local principal. Se nenhum valor for especificado, somente o código de idioma principal será processado.