Cómo utilizar PowerShell y la API con Agent o SSIS para automatizar la actualización de un conjunto de datos de Power BI

Abra Powershell (ISE o símbolo del sistema) como administrador:

En la pantalla del símbolo del sistema, escriba el comando "powershell”Para inicializar la interfaz de PowerShell.

Después de eso, escriba el comando “Módulo de instalación MicrosoftPowerBIMgmt" para instalar los cmdlets. Probablemente aparecerá una confirmación si confía en este repositorio. Marque la opción "Sí para todos":

Después de eso, los cmdlets ya están instalados y podemos comenzar a usarlos. Si desea utilizar la interfaz PowerShell ISE para instalar los cmdlets, no dude en hacerlo. La instalación sigue los mismos pasos. Si quieres saber más sobre estos cmdlets y algunos detalles más sobre la instalación, como instalar módulos por separado y también ejemplos usando PowerShell ISE, te recomiendo leer el artículo. [POWER BI] – Cmdlets para PowerShell – ¡Administrando Power Bi como un profesional!.

• Connect-PowerBIServiceAccount: Se utiliza para conectarse al servicio Power BI mediante el nombre de usuario y la contraseña de esta cuenta de Power BI.
• Invocar el método PowerBIRest: Se utiliza para realizar una llamada a la API de Power BI que realizará determinadas acciones según los parámetros utilizados.

A continuación, proporcionaré un script para actualizar un conjunto de datos específico:

#1. Autenticação
$Usuario = "[email protected]"
$Senha = "senha_dificil_123"

$SenhaSegura = ConvertTo-SecureString $Senha -AsPlainText -Force
$Credencial = New-Object System.Management.Automation.PSCredential($Usuario,$SenhaSegura)

Connect-PowerBIServiceAccount -Credential $Credencial

#2. Recupera o ID do Workspace e do Dataset
$Workspace_ID = "8fda9bda-13c5-45ec-9a4f-3bcfe51ed57f"
$Dataset_ID = "fd3df53a-9a3a-40ee-91f0-585c9fb52c67"

#3. Monta a URL de atualização do DS
$Url_Atualizacao = 'groups/' + $Workspace_ID + '/datasets/' + $Dataset_ID + '/refreshes'

#5. Executa a atualização e notifica por e-mail em caso de falha
$NotificacaoFalhaPorEmail = @{"notifyOption"="MailOnFailure"}

Invoke-PowerBIRestMethod -Url $Url_Atualizacao -Method Post -Body $NotificacaoFalhaPorEmail

Para identificar el ID del espacio de trabajo y del conjunto de datos, simplemente acceda al menú lateral de Power BI, abra el espacio de trabajo donde se encuentra este conjunto de datos y luego haga clic en el conjunto de datos que desea actualizar:

Cuando abre el conjunto de datos, puede obtener el espacio de trabajo y el ID del conjunto de datos de la URL:

Reemplace el script que puse a disposición con estos 2 ID:

#2. Recupera o ID do Workspace e do Dataset
$Workspace_ID = "ee72886a-26c8-4d59-97f6-e7b811adc507"
$Dataset_ID = "3aaf8f29-f54b-4b9c-a171-d8d0ef2fcea7"

Si desea actualizar más de un conjunto de datos en el script, hágalo así:

#2. Recupera o ID do Workspace e do Dataset
$Workspace_ID = "8fda9bda-13c5-45ec-9a4f-3bcfe51ed57f"

#3. Monta a URL de atualização do DS
$Url_Atualizacao1 = 'groups/' + $Workspace_ID + '/datasets/fd3df53a-9a3a-40ee-91f0-585c9fb52c67/refreshes'
$Url_Atualizacao2 = 'groups/' + $Workspace_ID + '/datasets/fd3df53a-9a3a-40ee-91f0-449e4c453c13/refreshes'
$Url_Atualizacao3 = 'groups/' + $Workspace_ID + '/datasets/fd3df53a-9a3a-40ee-91f0-fef43a0bc123/refreshes'

#5. Executa a atualização e notifica por e-mail em caso de falha
$NotificacaoFalhaPorEmail = @{"notifyOption"="MailOnFailure"}

Invoke-PowerBIRestMethod -Url $Url_Atualizacao1 -Method Post -Body $NotificacaoFalhaPorEmail
Invoke-PowerBIRestMethod -Url $Url_Atualizacao2 -Method Post -Body $NotificacaoFalhaPorEmail
Invoke-PowerBIRestMethod -Url $Url_Atualizacao3 -Method Post -Body $NotificacaoFalhaPorEmail

Después de realizar este cambio, guarde el script con el nombre que desee, pero la extensión del archivo debe ser .ps1.

Idealmente, este proceso de actualización de Power BI debería realizarse en el mismo trabajo que actualiza y procesa los datos de la base de datos:

Y en este nuevo paso, que será del tipo “Sistema operativo (CmdExec)”, colocarás el siguiente comando a ejecutar:
powershell.exe -ExecutionPolicy Unrestricted -File "C:\Scripts\Atualiza Power BI.ps1"

Recuerde cambiar la ruta del archivo .ps1 a la ubicación donde guardó su secuencia de comandos. Después de programar el trabajo, su informe de Power BI se actualizará automáticamente al final del procesamiento.

Para hacer esto, agregue una tarea "Ejecutar proceso", que se utiliza para ejecutar comandos a nivel del sistema operativo:

En la pantalla de configuración para esta tarea, escriba powershell.exe en el parámetro “Ejecutable” y -ExecutionPolicy sin restricciones -Archivo “C:\Scripts\Atualiza Power BI.ps1” en el parámetro “Argumentos”. Opcionalmente, cambie la configuración de "Estilo de ventana" a "Oculto", para que la ventana no aparezca en la pantalla durante la actualización:

Ejemplo:

Si el Agente SQL Server ya está ejecutando automáticamente su paquete SSIS, no necesita hacer nada más. De lo contrario, agregue otro paso al trabajo del Agente SQL Server para ejecutar el paquete que actualizará Power BI:

Cuando se ejecuta el trabajo, los datos de Power BI se actualizarán al final de la ejecución.