Coletor de metadados do PowerBI

O coletor de metadados do PowerBI fornece acesso somente leitura aos metadados de uma conta do PowerBI.

Power BI é uma coleção de serviços de software, apps e conectores que trabalham juntos para transformar fontes de dados não relacionadas em informações coerentes, visualmente imersivas e interativas. As fontes de dados podem incluir planilhas do Excel, data warehouses baseados em nuvem ou data warehouses híbridos no local. O Power BI permite que você se conete a fontes de dados, visualize e descubra informações importantes e compartilhe informações em toda a organização.

O coletor do Power BI coleta metadados dos espaços de serviço do Power BI. Use metadados colhidos para descobrir relatórios e painéis em espaços e executar análise de impacto para entender como as mudanças nas fontes de dados ascendentes afetam os relatórios do Power BI.

Versão compatível

O coletor oferece suporte à API do Power BI Cloud v 1,0.

Autenticação compatível

O Power BI oferece suporte a dois métodos de autenticação:

• Entidade de serviço
• Usuário e senha

O coletor coleta metadados para todos os aplicativos e espaços do Power BI aos quais a conta autenticada tem acesso.

Metadados catalogados

O coletor do Power BI cataloga as seguintes informações:

Tabela 1. Metadados coletados

Objeto	Informações coletadas
Espaços	Título, Descrição
Apps	Título, Descrição
Medidas do Power BI	Título, Descrição, está oculto, Expressão
Relatórios	Título, Tipo de relatório, URL externo, URL incorporado, Imagem de visualização (não compatível com tipos de relatório paginado), Data de criação, Modificado pela última vez, Criado por, Modificado pela última vez por, descrições
Páginas de relatório	Observação do título: As páginas de relatório em Apps não podem ser catalogadas ao usar a autenticação de entidade de serviço devido a restrições nas APIs do Power BI.
Painéis	URL externa, URL incorporada
Blocos do painel	URL de incorporação
Fontes de dados	Tipo de fonte de dados, Detalhes da conexão (tipo e caminho)
Modelo semântico	Título, URL externo, Descrição, Data de criação, Criado por, Atualizar programação
Fluxos de dados	Título, Modificado pela última vez, Descrição, Criado por, Programação de atualização
Tabelas do Power BI (modelo semântico e fluxos de dados)	Título, está oculto, São inseridos Dados, Descrição, Expressão de origem
Tabela calculada do Power BI	Título, está oculto, São inseridos Dados, Descrição, Expressão de origem
Colunas do Power BI	Título, Descrições, Tipo de dados, Tipo de coluna, está oculto, expressão
Arquivo tabular	Caminho do arquivo, Nome do arquivo
Diretório de arquivos	Caminho do diretório
Banco de dados	Título, Tipo, Identificador, Servidor, Porta
Esquema do banco de dados	Título
Tabela de banco de dados	Título
Coluna do banco de dados	Título
Tabela	Título, Descrição
Coluna	Tipo
Grupo de cálculo	Título, Descrição
Item de cálculo	Título, Descrição, Expressão

Relacionamentos entre objetos

As páginas do catálogo mostram relacionamentos entre os seguintes tipos de ativos de dados:

Tabela 2. Relações entre objetos catalogados

Página de ativo de dados	Relacionamento
App	Painel, Espaço
Coluna do Power BI	Tabela do Power BI
Fonte de dados	Modelo semântico, fluxo de dados, fonte de dados tabular (banco de dados, arquivo tabular)
Lado a Lado	Modelo semântico, Relatório e Painel
Painel	Bloco, Espaço
Bloco do painel	Modelo semântico associado
Modelo semântico	Bloco do painel, Relatório
Relatório	Bloco, Espaço, Páginas de relatório (não aplicável a tipos de relatório paginado), Modelo semântico (não aplicável a tipos de relatório paginado), Relatório Nota: No Power BI, os relatórios da aplicação e os respetivos relatórios de espaço associados são dois relatórios separados com IDs de relatório exclusivos. O coletor cataloga o relacionamento entre eles.
Páginas de relatório	Relatório (não aplicável para tipos de relatório paginado)
Modelo semântico	Bloco, Espaço, Relatório, Tabela, Fonte de dados, modelo semântico, Fluxo de dados
Espaço	Modelo semântico, Fluxo de dados, Painel, Aplicação
Fluxo de dados	Espaço, Tabela, Fonte de dados, Fluxo de dados
Tabela do Power BI	Modelo semântico, Fluxo de dados, coluna do Power BI, Medida do Power BI
Medida do Power BI	Tabela do Power BI
Fonte de dados tabulares (banco de dados, arquivo tabular)	Fonte de dados
Grupo de cálculo	Tabela do Power BI
Item de cálculo	Grupo de cálculo

Linhagem do PowerBI

As seguintes informações de linhagem são coletadas pelo coletor do Power BI. O coletor usa o. APIs do scanner do Power BI para estabelecer a linhagem para tabelas e colunas de origem. Certifique-se de se familiarizar com Limitações para as APIs do scanner

Tabela 3. Disponibilidade de linhagem por objeto

Objeto	Linhagem disponível
Bloco do painel	Modelo semântico associado
Modelo semântico	Fluxo de dados associado, Modelo semântico
Fluxo de dados	Fluxo de dados
Coluna do Power BI	Colunas associadas das quais a coluna origina seus dados ou calcula seus valores. Nota: A linhagem pode ser colhida de expressões do Power BI que usam parâmetros no lugar de nomes de servidor, esquema, tabela ou banco de dados. Os relacionamentos de catálogo e linhagem no nível de tabela e coluna não estão disponíveis entre tabelas ou colunas e relatórios por meio da API do Power BI.
Tabela do Power BI	Tabelas associadas das quais a tabela fornece seus dados Observação: Nota: O coletor usa expressões do Power BI retornadas pelas APIs para analisar a linhagem para as colunas/tabelas de origem.
Tabela calculada do Power BI	Tabelas e colunas do Power BI das quais a tabela calculada deriva seus valores.
Medida do Power BI	Colunas associadas das quais a medida fornece dados

A tabela a seguir lista operações e transformações de tabela compatíveis e incompatíveis. Isso inclui expressões de origem, colunas calculadas e expressões de medida usadas na coleta de metadados de linhagem. As operações não listadas não são colhidas.

Tabela 4. Expressões e transformações compatíveis para colher metadados de linhagem

Categoria	Categoria
Expressões parametrizadas compatíveis	O coletor analisa expressões de origem que usam parâmetros no lugar dos seguintes valores: Origem completa, servidor ou host, depósito, nome do banco de dados, nome do esquema, nome da tabela e expressões SQL.
Funções de dados compatíveis	CSV.Documento, Excel.Pasta de trabalho, Arquivo.Conteúdo, Pasta.Conteúdo, Pasta.Arquivos, JSON.Documento, ODBC.Fonte de Dados, ODBC.InferOptions, ODBC.Consulta, XML.Documento, Web.Contents, Web.Cabeçalhos, Web.BrowserContents, AmazonRedshift.Banco de Dados, SQL.Banco de Dados, bancos de dados SQL, Snowflake.Bancos de dados, PostgreSQL.Banco de dados, Databricks.Catálogos, Oracle.Banco de dados, Denodo.Contents, Databricks.Query, DatabricksMultiCloud.Catálogos, AnalysisServices.Banco de dados, GoogleBigQuery.Banco de dados
Funções de tabela compatíveis	Tabela.AdicionarColuna, Tabela.AddIndexColuna, Tabela.RenomeColunas, Tabela.NegedJoin, Tabela.ExpandTabelaColuna, Tabela.SplitColumn, Tabela.DuplicateColumn, Table.CombineColumns
Operações de tabela incompatíveis	Tabela.Pivot, Tabela.Cabeçalhos de promoção, Tabela.Cabeçalhos de demonstração, Tabela.Colunas de prefixo, Tabela.TransformNomeColunas de coluna, Tabela.Despiver, Tabela.UnpivotOutras Colunas, Tabela.AdicionarColunas ClusterColunas, Tabela.AdicionarColunas, Tabela.AgregaColunas de TabelaColunas, Table.Combine, Table.CombineColumnsToRecord, Table.ExpandRecordColunn, Table.Join, Table.transpose
Funções de fluxo de dados compatíveis	PowerPlatform.fluxos de dados, PowerBI.fluxos de dados
Funções de valor compatíveis	Valor.Consulta Native
Colunas calculadas compatíveis	A linhagem de expressões de coluna calculadas que contêm colunas com e sem referências de tabela, colunas ou tabelas com caracteres alfanuméricos, espaços, hifens e sublinhado são compatíveis
Medidas compatíveis	A linhagem de expressões de medida que contêm colunas ou tabelas com caracteres alfanuméricos, espaços, hifens, sublinhado e aspas adjacentes são compatíveis

Prepare-se para executar o coletor do PowerBI

Configure o registro, autenticação e permissões da aplicação Azure antes de executar o coletor.

Antes de Iniciar

Função necessária: administrador

Importante:

Um administrador do Power BI é necessário para habilitar configurações no Portal do administrador do Power BI.

Por Que e Quando Desempenhar Esta Tarefa

O coletor usa o registro da aplicação Azure e oferece suporte a dois métodos de autenticação: Entidade de serviço ou nome de usuário e senha. Você deve registrar uma aplicação, configurar a autenticação, habilitar a verificação de metadados e recuperar o ID do locatário. Como opção, configure a colheita de imagem do relatório e o mapeamento de linhagem.

Procedimento

1. Registre uma aplicação no Azure e crie credenciais de cliente.

   Consulte Registre a aplicação Power BI.

2. Configure a autenticação com base em seu método preferencial.

   • Para autenticação da entidade de serviço, consulte Configure a autenticação principal de serviço do Power BI.

   • Para autenticação de nome de usuário e senha, consulte Configure a autenticação de nome de usuário e senha do Power BI.

3. Habilite a verificação de metadados para acessar informações detalhadas da fonte de dados.

   Consulte Configure a verificação de metadados do Power BI.

4. Obtenha o ID do locatário do Power BI.

   Consulte Obter ID de locatário do Power BI.

5. Opcional: Configure a coleta de imagens de relatório para coletar imagens de visualização de relatórios do Power BI.

   Consulte Configure a colheita de imagens de relatório do Power BI.

6. Opcional: Configure o mapeamento de linhagem para conexões de ODBC, aliases de servidor ou instruções SQL personalizadas.

   Consulte Configure o mapeamento de linhagem do Power BI.

Registre a aplicação Power BI

Registre uma aplicação no Azure e crie credenciais de cliente para autenticação de coletor do Power BI.

Antes de Iniciar

Função necessária: administrador

Você deve ter permissões para registrar aplicações no Azure Active Directory.

Por Que e Quando Desempenhar Esta Tarefa

Registre uma aplicação no Azure para obter o ID do cliente e o segredo do cliente necessários para a autenticação do coletor do Power BI.

Procedimento

1. Registre uma nova aplicação no Azure.
   1. Navegue até Portal do Azure .
   2. Selecione Registros da aplicação Dos serviços do Azure.
   3. Selecione Novo registro .
   4. Insira as informações de registro.
      • Nome da aplicação: DataDotWorldPowerBIApplication
      • Tipos de conta compatíveis: Somente contas neste diretório organizacional
   5. Selecione Registrar para concluir o registro.
2. Crie um segredo do cliente.
   1. Na página da aplicação, selecione Certificados e segredos .
   2. Selecione Novo segredo do cliente .
   3. Adicione uma descrição para o segredo.
   4. Selecione a data de vencimento desejada.
   5. Selecione Adicionar.
   6. Copie o valor secreto.

      Salve este valor com segurança. Você o usará ao configurar o coletor do Power BI.

3. Obtenha o ID do cliente.
   1. Selecione Visão geral na barra lateral esquerda da página da aplicação.
   2. Copie o ID do cliente da seção Essenciais.

      Salve este valor. Você o usará ao configurar o coletor do Power BI.

Configure a autenticação principal de serviço do Power BI

Configure a autenticação da entidade de serviço para habilitar a coleta de metadados do Power BI.

Antes de Iniciar

Função necessária: administrador

Você deve ser um administrador do Power BI para habilitar as configurações da entidade de serviço.

Importante:

Ao executar em uma entidade de serviço, não deve haver permissões obrigatórias de consentimento do administrador do Power BI definidas em seu app. Para obter mais informações, consulte Documentação da Microsoft .

Por Que e Quando Desempenhar Esta Tarefa

Ao usar a autenticação de entidade de serviço, o coletor colhe todos os objetos, exceto espaços pessoais, espaços de trabalho do usuário e páginas de relatório. Para colher todos os aplicativos e espaços no locatário, habilite Catálogo de todos os espaços e aplicações no locatário. Para incluir espaços pessoais e do usuário, habilite o conteúdo do catálogo do Meu espaço do usuário.

Nota:

Para colher páginas de relatório, conceda à entidade de serviço acesso a cada espaço. A API do administrador não tem um endpoint para páginas de relatório.

Procedimento

1. Entre no Power BI usando uma conta de administrador do Power BI.
2. Navegar até Configurações > Portal do administrador.
3. Habilite o acesso à API principal de serviço.
   1. Em Configurações do desenvolvedor , localizar Os principais de serviço podem usar APIs de malha .
   2. Habilite a configuração.
   3. Selecione se a configuração se aplica a toda a organização ou a grupos de segurança específicos.

      Se estiver usando grupos de segurança específicos, confirme se o grupo inclui a entidade de serviço.

   4. Selecione Aplicar para salvar as mudanças.
4. Opcional: Adicione a entidade de serviço aos espaços para fluxo de dados e acesso à página de relatório.

   Os fluxos de dados exigem que a entidade de serviço tenha pelo menos acesso de Colaborador ao espaço. Para páginas de relatório, a entidade de serviço também precisa de acesso ao espaço porque a API do administrador não fornece um endpoint para páginas de relatório.

   1. Abra o espaço.
   2. Selecione Gerencie o acesso .
   3. PESQUISE a entidade de serviço ou o grupo de segurança ao qual a entidade de serviço pertence.
   4. Selecione o nível de acesso apropriado.

      Se fluxos de dados forem usados, selecione pelo menos Acesso de colaborador. Caso contrário, selecione Visualizador.

   5. Selecione Adicionar.

Configure a autenticação de nome de usuário e senha do Power BI

Configure permissões de API para autenticação de nome de usuário e senha para habilitar a coleta de metadados do Power BI.

Antes de Iniciar

Função necessária: administrador

Você deve ter permissões para configurar permissões de API no Azure Ative Directory.

Nota:

Somente administradores do locatário podem conceder consentimento do administrador.

Por Que e Quando Desempenhar Esta Tarefa

Ao usar a autenticação do usuário, o coletor colhe todos os objetos, exceto espaços pessoais, espaços de trabalho do usuário e páginas de relatório. Para colher todos os aplicativos e espaços no locatário, habilite Catálogo de todos os espaços e aplicações no locatário. Para incluir espaços pessoais e do usuário, habilite o conteúdo do catálogo do Meu espaço do usuário.

Para colher páginas de relatório, conceda ao usuário acesso a cada espaço. A API do administrador não tem um endpoint para páginas de relatório.

Nota:

O catálogo de todos os espaços de trabalho e aplicações no locatário requer que o usuário tenha direitos de Administrador global do Microsoft 365 ou Administrador de serviços do Power BI para verificação de metadados. Para obter detalhes, consulte Documentação do Power BI .

Procedimento

1. Navegue até o Portal do Azure e abra o registro da aplicação.
2. Selecione Permissões de API .
3. Adicione permissões do Microsoft Graph.
   1. Selecione Adicione uma permissão .
   2. PESQUISE e selecione Gráfico da Microsoft .
   3. Adicione as seguintes permissões.
      • Permissão da aplicação: Application.Read.All
      • Permissão delegada: User.Read (atribuída por padrão)
4. Adicione permissões de serviço do Power BI.
   1. Selecione Adicione uma permissão .
   2. PESQUISE e selecione Serviço do Power BI .
   3. Selecione Permissões delegadas .
   4. Adicione as seguintes permissões.
      • Ler.Tudo
      • Painel.Ler.Tudo
      • Dataflow.Ler.Tudo
      • Conjunto de dados.Ler.Tudo
      • Relatório.Ler.Tudo
      • Locatário.Ler.Tudo
      • Read.All.Espaço.Ler.Tudo
5. Selecione Conceda consentimento do administrador botão localizado ao lado de Adicione uma permissão botão.

   Esta permissão permite que o coletor seja executado sem solicitar permissão em cada execução.

Configure a verificação de metadados do Power BI

Ative a verificação de metadados para acessar informações detalhadas da fonte de dados, incluindo tabelas e colunas.

Antes de Iniciar

Função necessária: administrador

Você deve ser um administrador do Power BI para habilitar as configurações de verificação de metadados.

Por Que e Quando Desempenhar Esta Tarefa

Verificação de metadados Fornece acesso a informações detalhadas da fonte de dados, como tabelas e colunas, por meio de APIs de administração somente leitura do Power BI. O coletor usa as APIs do scanner do Power BI para estabelecer a linhagem para tabelas e colunas de origem. Revise o. Limitações para as APIs do scanner antes de configurar o coletor.

Procedimento

Habilite a verificação de metadados com base no seu método de autenticação.

• Para autenticação principal de serviço:

  1. Siga o. Documentação do Power BI Para habilitar a autenticação principal de serviço para APIs somente leitura do Power BI
  2. Habilite as seguintes configurações de locatário aprimoradas para verificação de metadados:
     • Melhore as respostas das APIs do administrador com metadados detalhados
     • Aprimore as respostas das APIs do administrador com expressões DAX e mashup

• Para autenticação de nome de usuário e senha, habilite as seguintes configurações de locatário aprimoradas para verificação de metadados:

  Importante:

  O usuário deve ter direitos de administrador (administrador global do Microsoft 365 ou administrador de serviço do Power BI) para usar a verificação de metadados. Para obter detalhes, consulte Documentação do Power BI .
  • Melhore as respostas das APIs do administrador com metadados detalhados
  • Aprimore as respostas das APIs do administrador com expressões DAX e mashup

Obter ID de locatário do Power BI

Recupere o ID do locatário da aplicação Power BI.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

O ID do locatário é necessário ao configurar o coletor do Power BI. Recupere este valor da aplicação Power BI.

Procedimento

1. Na aplicação Power BI, selecione o ícone de ponto de interrogação.
2. Selecione Sobre o Power BI .
3. Copie o ID do locatário do final do URL do locatário.

   Salve este valor. Você o usará ao configurar o coletor do Power BI.

Configure a colheita de imagens de relatório do Power BI

Ative a coleta de imagens de relatório para coletar imagens de visualização de relatórios do Power BI.

Antes de Iniciar

Função necessária: administrador

Nota:

A coleta de imagens de relatório não é compatível com aplicativos Power BI.

Por Que e Quando Desempenhar Esta Tarefa

Ative a coleta de imagens de relatório para coletar imagens de visualização de relatórios do Power BI para exibição no Catálogo de dados.

Procedimento

1. Habilite a configuração de exportação no Portal do administrador do Power BI.
   1. Entre no Power BI usando uma conta de administrador do Power BI.
   2. Navegar até Configurações > Portal do administrador.
   3. Localize e habilite o. Exporte relatórios como arquivos de imagem configuração do Configurações do administrador .
2. Verifique a capacidade do espaço.

   Confirme se os relatórios a serem exportados estão localizados em um espaço com capacidade Premium, Incorporado ou Fabric. Para obter detalhes, consulte Documentação do Power BI .

Configure o mapeamento de linhagem do Power BI

Crie um arquivo YAML para mapear fontes de dados para coleta de linhagem.

Antes de Iniciar

Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

Esta é uma tarefa opcional para colher informações de linhagem. Crie um arquivo YAML e passe-o usando a opção Arquivo de mapeamento de nome da fonte de dados ao executar o coletor.

Configure um arquivo YAML nos seguintes cenários:

Tabela 5. Cenários de mapeamento de linhagem

Cenário	Detalhes	Ação
Conexões de ODBC no Power BI	Você tem uma fonte de dados no Power BI que usa uma conexão ODBC. Nessas instâncias, o Power BI não fornece o tipo de host ou banco de dados da origem	No arquivo YAML, mapeie o DSN para um host e tipo de banco de dados específico. Se o nome do banco de dados estiver ausente na fonte de dados do Power BI, adicione a opção DefaultDatabaseName à fonte de dados no arquivo YAML
Vários aliases de nome de servidor	Você tem vários nomes de servidor (aliases) para a mesma instância de banco de dados (host) e o coletor de banco de dados usa um alias diferente do definido na conexão do Power BI	Use o arquivo YAML para mapear o host do banco de dados para aliases especificados pelo usuário
Instruções SQL personalizadas	As instruções SQL personalizadas são usadas nas definições de origem da tabela do Power BI. Atualmente, o coletor do Power BI oferece suporte à conexão com os seguintes tipos de banco de dados para resolver a linhagem de instruções SQL: Snowflake, SQL Server, PostgreSQL, Redshift, Oracle, Databricks, denodo, BigQuery. A resolução de linhagem para origens de tabela que usam instruções SQL oferece suporte somente a SQL que consiste em uma única instrução SELECT	Configure bancos de dados especificados em instruções SQL personalizadas incluindo datasourceKey, host e credenciais seguras usando variáveis de ambiente

Nota:

Você pode usar variáveis de ambiente no arquivo para obter informações confidenciais, como senhas.

Procedimento

1. Crie um arquivo YAML chamado datasources.yml.
2. Configure o arquivo YAML com base no seu cenário.

   • Para vários aliases de nome de servidor:

     Adicione o seguinte para mapear um alias de host:

     datasources:
      - datasourceKey: "<host or data source key in Power BI source>"
       host: <my-datasource-host>

     Por exemplo, se a origem da tabela do Power BI for:

     let Source = Snowflake.Database("host-alias.snowflakecomputing.com", "KOS_TEST"),
     PowerBiTest_Test_Table = Source{[Schema="POWERBI_TEST",Item="TEST_TABLE"]}[Data]
     in PowerBiTest_Test_Table

     Em seguida, o datasourceKey será host-alias.snowflakecomputing.com. Seu arquivo datasources.yml será parecido com:

     datasources:
     - datasourceKey: host-alias.snowflakecomputing.com
     host: host-actual.snowflakecomputing.com

   • Para instruções SQL personalizadas:

     Adicione o seguinte para bancos de dados especificados em instruções SQL personalizadas. Variáveis de ambiente são compatíveis:

     datasources:
       - datasourceKey: "<host or data source key in Power BI source>"
       OR
      - name: <data source name>
      host: <my-datasource-host>
      databaseUsername: <username> # recommend setting up env variable
      databasePassword: <password> # recommend setting up env variable

     Use a opção a seguir para especificar a quais bancos de dados uma configuração de fonte de dados se aplica. Se não forem fornecidas, presume-se que as configurações da fonte de dados se aplicam a todos os bancos de dados no host fornecido:

     applicableDatabases:
       - <database_name>

     Por exemplo:

     datasources:
     - datasourceKey: "example.cpcnqsn422gx.us-east-1.rds.amazonaws.com, 1433"
      host: example.cpcnqsn422gx.us-east-1.rds.amazonaws.com
      databaseUsername: ${DB_USERNAME}
      databasePassword: ${DB_PASSWORD}
      applicableDatabases:
      - 8bank_database

   • Para conexões ODBC:

     Mapeie o DSN para um tipo e host de banco de dados específico. Para conexões ODBC, liste as fontes de dados com o host correspondente e o tipo de banco de dados. Se as conexões de ODBC usarem odbc.Query, especifique o nome de usuário e a senha. Se as conexões ODBC especificarem o nome do banco de dados, inclua defaultDatabaseName:

     datasources:
     - name: "Name-for-datasource"
     host: <my-datasource-host>
     databaseType: <type-of-database>
     databaseUsername: <username> # optional
     databasePassword: <password> # optional
     defaultDatabaseName: <database name> # optional

     A lista de databaseTypes possíveis são: postgres, redshift, bigquery, oracle, mysql, netezza, snowflake, sqlanywhere, sqlserver, databricks, denodo. Os tipos não diferenciam maiúsculas de minúsculas, mas devem ser uma única palavra sem espaços.

     Por exemplo:

     datasources:
     - name: "SQL Server DSN Production"
     databaseType: sqlserver
     host: 8bank-sqlserver.cpetgx.us-east-1.rds.amazonaws.com

3. Opcional: Se necessário, adicione opções de configuração específicas do banco de dados.

   Opções de propriedades JDBC:

   Tabela 6. Propriedades de JDBC

   Opção	Descrição
   JdbcProperties	Várias propriedades JDBC podem ser especificadas usando uma lista YAML. O formato esperado é jdbcProperties Por exemplo: JdbcProperties: Encrypt Para vários valores: jdbcProperties: - encrypt=true - readOnly=true

   Opções de credenciais do banco de dados do Snowflake:

   Tabela 7. Opções do Snowflake

   Opção	Descrição
   Nome de usuário do databaseUsername	Necessário se consultas SQL personalizadas forem usadas em fontes de banco de dados do Power BI
   DatabasePassword	Necessário se consultas SQL forem usadas e se uma chave privada não for usada para autenticação no Snowflake
   SnowflakePrivateKeyFile: PrivateKeyFile	Necessário se consultas SQL forem usadas e se uma chave privada for usada para autenticação no Snowflake
   KeyFilePassword	Necessário se consultas SQL forem usadas e se uma chave privada for usada para autenticação no Snowflake
   SnowflakeRole: Função	Necessário se consultas SQL forem usadas
   SnowflakeWarehouse: Depósito	Use para substituir depósitos usados em expressões do Power BI na conexão do banco de dados

   Opções de credenciais do banco de dados de bancos de dados:

   Tabela 8. Opções de Databricks

   Opção	Descrição
   DatabricksHttpPath	Necessário se o banco de dados de origem for Databricks

   Opções do Oracle Autonomous Database:

   Tabela 9. Opções do Oracle Autonomous Database

   Opção	Descrição
   OracleAutonomousDbConnectionString	Necessário se a origem for um Oracle Autonomous Database. A cadeia de caracteres de conexão deve estar no formato: jdbc:oracle:thin:<host>:<port>/<service_name>, jdbc:oracle:thin:@(address=(protocol=tcps)(port=<port>)(host:<host>)) (connect_data=(service_name=<service_name>)) (security=(ssl_server_dn_match=yes)), or jdbc:oracle:thin:@alias_name?TNS_ADMIN=/path/to/wallet

   Opções do BigQuery:

   Tabela 10. Opções do BigQuery

   Opção	Descrição
   projeto	Necessário se a origem for uma tabela do BigQuery
   BigQueryCredentialJsonString	Necessário para fornecer credenciais do BigQuery

   Exemplo de banco de dados do BigQuery:

   datasources:
    - project: "project-name"
   databaseType: bigquery
   bigQueryCredentialJsonString: '{"key": "value","key": "value"}'

4. Salve o arquivo datasources.yml.
5. Passe o arquivo YAML para o coletor usando o parâmetro --datasource-mapping-file ao executar o coletor.

Crie um coletor de metadados do PowerBI

Crie um coletor para importar metadados do PowerBI.

Antes de Iniciar

Antes de começar, verifique o seguinte:

• Um MID Server está configurado para os coletores. Para obter mais informações, consulte MID Server para coletores de metadados.
• Todas as tarefas por requisito foram concluídas. Para obter mais informações, consulte Prepare-se para executar o coletor do PowerBI.
• Função necessária: Connection-admin

Procedimento

1. Navegar até Tudo > Malha de dados do fluxo de trabalho > Página inicial da malha de dados de fluxo de trabalho.
2. Selecione o Connect Hub na barra lateral esquerda.
3. Selecionar Criar > Coletor de metadados.
4. Na lista Sistema, selecione PowerBI .
5. Preencha o formulário.

   Tabela 11. Novo formulário de coletor de metadados do governo do PowerBI

   Campo	Descrição
   Nome da conexão	Identificador exclusivo da conexão. Este campo não pode ser modificado depois que a conexão for estabelecida.
   Descrição resumida	Finalidade e detalhes da conexão.

6. Configure as opções de autenticação.

   Tabela 12. Opções de autenticação

   Campo	Descrição
   Autentique usando o nome de usuário e senha do Azure	Nome de usuário e senha do Azure Active Directory. Defina o ID do locatário do Azure se quiser especificar o ID do locatário do Azure ao usar a autenticação de nome de usuário e senha.
   Autentique usando a entidade de serviço do Azure	ID do locatário da aplicação do Azure Active Directory para a aplicação Power BI. Para encontrar o ID do locatário, selecione o ponto de interrogação no aplicativo Power BI e escolha Sobre o Power BI. O ID do locatário é encontrado no final do URL do locatário.

7. Configure o ID do cliente e os detalhes do segredo do cliente.

   Tabela 13. Detalhes da configuração

   Campo	Descrição
   ID do cliente do Microsoft Entra	ID do cliente da aplicação para a aplicação PowerBI.
   Segredo do cliente do Microsoft Entra	Segredo do cliente da aplicação para a aplicação PowerBI.

8. Configure o escopo do espaço e as opções de filtros.

   Tabela 14. Escopo do espaço e opções de filtros

   Campo	Descrição
   Desabilite a coleção de linhagem	Opção para ignorar a coleta de metadados de linhagem de expressões de origem do Power BI.
   Conteúdo do catálogo do Meu espaço do usuário	Opção para catalogar o conteúdo do Meu espaço de um usuário no Power BI. Padrão: Ignore o espaço do usuário.
   Catalogue todos os espaços de trabalho e aplicações no locatário	Opção para catalogar todos os espaços e aplicações em um locatário, em vez de apenas os espaços e aplicações aos quais as credenciais têm acesso explícito. Os privilégios de administrador são necessários para as credenciais usadas.
   Incluir espaço(s) do Power BI	Espaços a serem coletados. Insira o nome exato do espaço ou uma expressão regular para corresponder. Nota: Se o nome de um espaço incluir caracteres especiais [. , * , ? , ( , ) , , ] , | , cada caractere especial deve ser escapado com uma barra invertida (). Por exemplo, insira Espaço (Dev) para Espaço (Dev).
   Exclua espaços de trabalho do Power BI	Espaços de trabalho do Power BI e seus conteúdos a serem excluídos da catalogação. Insira o nome exato do espaço ou uma expressão regular para corresponder. Se Incluir espaços e Excluir espaços estiverem configurados, Incluir espaços terá precedência. Nota: Se o nome de um espaço incluir caracteres especiais [. , * , ? , ( , ) , , ] , | , cada caractere especial deve ser escapado com uma barra invertida (). Por exemplo, insira Espaço (Dev) para Espaço (Dev).

9. Configure as opções de conexão e confiabilidade.

   Tabela 15. Opções de conexão e confiabilidade

   Campo	Descrição
   Tamanho máximo da expressão do Power BI	Número máximo de caracteres em uma expressão do Power BI que é analisada para metadados de linhagem. Expressões maiores que este valor são ignoradas. Padrão: 32000
   Arquivo de mapeamento do nome da fonte de dados	Arquivo que mapeia detalhes de origem de ODBC configurado no datasources.yml arquivo. Carregue o arquivo se você tiver configurado os detalhes de origem de ODBC.
   Imagens de visualização do relatório do catálogo	Opção para catalogar imagens de visualização. Padrão: falso
   Desabilite a espera máxima de solicitações	Opção para desabilitar a espera que a API do Power BI redefina os limites de limitação (código de erro 429). Quando não selecionado, o coletor tenta novamente a cada 5 minutos por até uma hora. Quando selecionado, as configurações Máximo de novas tentativas e Atraso de novas tentativas são usadas.
   Máximo de novas tentativas	Número de vezes que o sistema tenta novamente uma chamada de API com falha. Padrão: 5
   Atraso de nova tentativa	Número de segundos para aguardar entre as tentativas de nova tentativa para uma chamada de API com falha. Padrão: 2 segundos

10. Selecione Save (Salvar).

Resultado

O coletor de metadados é criado e aparece na página Conectores com um status configurado. Agora, ele está pronto para se conectar ao sistema de origem e colher metadados.

O que Fazer Depois

Depois de criar o coletor, você pode executar qualquer uma das seguintes tarefas:

• Execute o coletor manualmente para colher metadados imediatamente. Consulte Execute coletores de metadados manualmente.
• Automatize a coleta de metadados programando execuções regulares do coletor. Consulte Execuções do coletor de metadados de programação.
• Monitore o status de execução e solucione problemas exibindo os logs de tempo de execução. Consulte Exibir logs de tempo de execução para execuções do coletor.
• Descubra e avalie os ativos de dados coletados no Catálogo de dados. Consulte Que rege o. Catálogo de dados.