Para exportar e importar dados no Microsoft Power BI® e gerenciar os vários objetos que compõem a implementação do Power BI como parte de uma cadeia, adicione uma etapa que inclua um comando de conexão do Microsoft Power BI.
Para habilitar esses comandos, primeiro um administrador de TI cria um conector do Power BI.
Observação: O conector não pode se conectar ao Power BI com a autenticação multifator (MFA) ativada.
Adicionar linhas ao conjunto de dados
Para adicionar novas linhas de dados a uma tabela em um conjunto de dados de um espaço de trabalho, use o comando Add rows to dataset.
Observação: Esse comando considera as linhas duplicadas como adicionadas, mesmo quando ignoradas no Power BI.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Digite o ID do conjunto de dados. |
| Nome da tabela |
Digite o nome da tabela à qual você deseja adicionar linhas. |
| Dados |
Digite o arquivo que contém os dados a serem adicionados à tabela. |
| Tipo de dados |
Selecione se Data é JSON ou CSV. |
| Delimitador |
Se Data Type for CSV, insira o delimitador usado no arquivo. |
Saídas
| Saída |
Tipo de saída |
| Linhas adicionadas |
Inteiro |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Vincular conjunto de dados ao gateway
Para vincular um conjunto de dados de um espaço de trabalho a um gateway, use o comando Bind dataset to gateway. Somente suportado pelo Data Gateway local.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Insira o ID do conjunto de dados. |
| Gateway |
Digite a ID do gateway. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Clonar relatório
Para clonar um relatório de um espaço de trabalho, use o comando Clone report.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Insira o ID do espaço de trabalho. |
| ID do relatório |
Digite o ID do relatório. |
| Nome |
Digite o nome do novo relatório criado. |
| ID do conjunto de dados de destino |
Digite o ID do conjunto de dados para o novo relatório. Para associar o novo relatório ao mesmo conjunto de dados que ID do relatório, deixe em branco. |
| ID do espaço de trabalho de destino |
Digite o ID do espaço de trabalho para o novo relatório. Para "My Workspace", digite um GUID vazio de 00000000-0000-0000-0000-0000000000.Para associar o novo relatório ao mesmo espaço de trabalho de ID do espaço de trabalho, deixe em branco. |
Saídas
| Saída |
Tipo de saída |
| Relatório |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Criar conjunto de dados
Para criar um novo conjunto de dados em um espaço de trabalho, use o comando Create dataset.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| Nome |
Digite o nome do conjunto de dados. |
| Tabelas |
Insira as tabelas no conjunto de dados. |
Saídas
| Saída |
Tipo de saída |
| Conjunto de dados |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Criar local de upload temporário
Para criar um armazenamento temporário de blob, como para importar arquivos .PBIX entre 1 GB e 10 GB, use o comando Create temporary upload location.
Para importar arquivos .PBIX grandes, crie um local de upload temporário, carregue o arquivo .PBIX usando o URL de assinatura de acesso compartilhado (SAS) da resposta e chame Post Import to Group e especifique o fileUrl para ser o URL do SAS no corpo da solicitação.
Observação: A importação de arquivos .PBIX grandes só está disponível para espaços de trabalho com capacidade premium e para arquivos .PBIX entre 1 GB e 10 GB.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
Saídas
| Saída |
Tipo de saída |
| URL |
String |
| Expira em |
Data |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Excluir todas as linhas da tabela
Para excluir todas as linhas de uma tabela no conjunto de dados de um espaço de trabalho, use o comando Delete all rows in table.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Digite o ID do conjunto de dados. |
| Nome da tabela |
Digite o nome da tabela da qual você deseja excluir as linhas. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Excluir conjunto de dados
Para excluir um conjunto de dados de um espaço de trabalho, use o comando Delete dataset.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Insira o ID do conjunto de dados. |
Saídas
| Saída |
Tipo de saída |
| Conjunto de dados |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Excluir relatório
Para excluir um relatório de um espaço de trabalho, use o comando Delete report.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Insira o ID do espaço de trabalho. |
| ID do relatório |
Digite o ID do relatório. |
Saídas
| Saída |
Tipo de saída |
| ID do relatório excluído |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Exportar relatório
Para exportar um relatório de um espaço de trabalho para um arquivo .PBIX, use o comando Exportar relatório.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Insira o ID do espaço de trabalho. |
| ID do relatório |
Digite o ID do relatório. |
Saídas
| Saída |
Tipo de saída |
| Exportação de relatório (.PBIX) |
Arquivo |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Obter conjunto de dados
Para recuperar um conjunto de dados de um espaço de trabalho, use o comando Get dataset.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Insira o ID do conjunto de dados. |
Saídas
| Saída |
Tipo de saída |
| Conjunto de dados |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Obter fontes de dados do conjunto de dados
Para recuperar uma lista de fontes de dados para o conjunto de dados de um espaço de trabalho, use o comando Get dataset datasources.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Insira o ID do conjunto de dados. |
Saídas
| Saída |
Tipo de saída |
| Fontes de dados |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Obter tabelas do conjunto de dados
Para recuperar uma lista de tabelas em um conjunto de dados de um espaço de trabalho, use o comando Get dataset tables.
Observação: Esse comando é compatível apenas com conjuntos de dados Push.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Insira o ID do conjunto de dados. |
Saídas
| Saída |
Tipo de saída |
| Tabelas |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Obter relatório
Para recuperar um relatório de um espaço de trabalho, use o comando Get report.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Insira o ID do espaço de trabalho. |
| ID do relatório |
Digite o ID do relatório. |
Saídas
| Saída |
Tipo de saída |
| Relatório |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Importar arquivo
Para criar novo conteúdo em um espaço de trabalho a partir de um arquivo .PBIX, use o comando Importar arquivo.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| Nome do conjunto de dados |
Digite o nome de exibição dos dados, incluindo a extensão do arquivo. |
| Em caso de conflito de nomes |
Selecione o que fazer se já existir um conjunto de dados com o mesmo nome. Por padrão, Ignorar. |
| Arquivo .PBIX |
Ao importar um arquivo .PBIX, digite o arquivo a ser importado. O arquivo deve ter menos de 1 GB. |
| Informações de importação |
Se você estiver importando um arquivo .PBIX grande, insira seus detalhes. |
| Executar de forma assíncrona |
Para não esperar a conclusão da importação, marque essa caixa. |
Saídas
| Saída |
Tipo de saída |
| Importação |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Listar dashboards
Para listar os painéis que existem em um espaço de trabalho e que o usuário pode acessar, use o comando List dashboards.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
Saídas
| Saída |
Tipo de saída |
| Painéis |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Listar conjuntos de dados
Para listar os conjuntos de dados que existem em um espaço de trabalho e que o usuário pode acessar, use o comando List datasets.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
Saídas
| Saída |
Tipo de saída |
| Conjuntos de dados |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Listar fontes de dados do gateway
Para listar os recursos de dados de um gateway, use o comando Listar recursos de dados do gateway.
Propriedades
| Propriedade |
Detalhes |
| ID do gateway |
Digite o ID do gateway. |
Saídas
| Saída |
Tipo de saída |
| Fontes de dados |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Listar gateways
Para listar o gateway do qual o usuário é administrador, use o comando Listar gateways.
Propriedades
Nenhum
Saídas
| Saída |
Tipo de saída |
| Portas de entrada |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Relatórios de listagem
Para listar os relatórios de um espaço de trabalho, use o comando Listar relatórios.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
Saídas
| Saída |
Tipo de saída |
| Relatórios |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Reagrupar relatórios ao conjunto de dados
Para vincular novamente um relatório de um espaço de trabalho a um conjunto de dados, use o comando Rebind reports to dataset.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Insira o ID do espaço de trabalho. |
| ID do relatório |
Insira o ID do relatório. |
| ID do conjunto de dados |
Insira o ID do novo conjunto de dados para o relatório de recuperação. |
Saídas
| Saída |
Tipo de saída |
| ID do relatório |
String |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Atualizar conjunto de dados
Para atualizar o conjunto de dados de um espaço de trabalho, use o comando Refresh dataset.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Digite o ID do espaço de trabalho. |
| ID do conjunto de dados |
Digite o ID do conjunto de dados. |
| Tipo de notificação |
Selecione o tipo de notificação a ser enviada quando a atualização for concluída. |
Saídas
Nenhum
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |
Atualizar o conteúdo do relatório
Para atualizar um relatório de um espaço de trabalho para que tenha o mesmo conteúdo de outro relatório, use o comando Update report content.
Propriedades
| Propriedade |
Detalhes |
| ID do espaço de trabalho |
Insira o ID do espaço de trabalho. |
| ID do relatório |
Insira o ID do relatório. |
| ID do relatório de origem |
Insira o ID do relatório de origem. |
| ID do espaço de trabalho de origem |
Insira o ID do espaço de trabalho com o relatório de origem. |
Saídas
| Saída |
Tipo de saída |
| Relatório |
JSON |
Códigos de saída
| Código |
Tipo |
Detalhes |
| 0 |
Sucesso |
Sucesso |
| 1 |
Erro |
Ocorreu um erro durante a execução |
| 2 |
Erro |
Ocorreu um erro ao autenticar com o Power BI |