Aktualisieren mit Azure Automation

Mithilfe von Azure Automation und PowerShell-Runbooks können Sie automatisierte Datenaktualisierungsvorgänge für Ihre Azure Analysis-Tabellenmodelle ausführen.

Das Beispiel in diesem Artikel verwendet das SqlServer-PowerShell-Modul. Ein PowerShell-Beispielrunbook, das die Aktualisierung eines Modells veranschaulicht, wird weiter unten in diesem Artikel bereitgestellt.

Authentifizierung

Alle Aufrufe müssen mit einem gültigen Microsoft Entra ID-Token (OAuth 2) authentifiziert werden. Das Beispiel in diesem Artikel verwendet einen Dienstprinzipalnamen (Service Principal Name, SPN) für die Authentifizierung bei Azure Analysis Services. Weitere Informationen finden Sie unter Erstellen eines Dienstprinzipals im Azure-Portal.

Voraussetzungen

Installieren von SqlServer-Modulen aus dem PowerShell-Katalog

1. Klicken Sie in Ihrem Azure Automation-Konto auf Module und anschließend auf Katalog durchsuchen.

2. Suchen Sie über die Suchleiste nach SqlServer.

   

3. Wählen Sie „SqlServer“ aus, und klicken Sie dann auf Importieren.

   

4. Klicken Sie auf OK.

Erstellen eines Dienstprinzipals (SPN)

Informationen zum Erstellen eines Dienstprinzipals finden Sie unter Erstellen eines Dienstprinzipals im Azure-Portal.

Konfigurieren von Berechtigungen in Azure Analysis Services

Der von Ihnen erstellte Dienstprinzipal muss über Serveradministratorberechtigungen auf dem Server verfügen. Weitere Informationen finden Sie unter Hinzufügen eines Dienstprinzipals zur Serveradministratorrolle.

Entwerfen des Azure Automation-Runbooks

1. Erstellen Sie im Automation-Konto eine Anmeldeinformationsressource, die verwendet wird, um den Dienstprinzipal sicher zu speichern.

   

2. Geben Sie die Details für die Anmeldeinformationen ein. Geben Sie bei Benutzername die Anwendungs-ID (App-ID) des Dienstprinzipals und dann bei Kennwort das Geheimnis für den Dienstprinzipal ein.

   

3. Importieren Sie das Automation-Runbook.

   

4. Suchen Sie nach der Datei Refresh-Model.ps1, geben Sie einen Namen und eine Beschreibung an, und klicken Sie dann auf Erstellen.

   Hinweis

   Verwenden Sie das Skript aus dem Abschnitt PowerShell-Beispielrunbook am Ende dieses Dokuments, um eine Datei namens „Refresh-Model.ps1“ zu erstellen und auf dem lokalen Computer zu speichern, um sie in Runbook zu importieren.

   

5. Nachdem das Runbook erstellt wurde, wechselt es automatisch in den Bearbeitungsmodus. Wählen Sie Veröffentlichen aus.

   

   Hinweis

   Die zuvor erstellte Anmeldeinformationsressource wird mit dem Befehl Get-AutomationPSCredential vom Runbook abgerufen. Dieser Befehl wird dann an den PowerShell-Befehl Invoke-ProcessASADatabase übergeben, um die Authentifizierung bei Azure Analysis Services durchzuführen.

6. Klicken Sie auf Start, um das Runbook zu testen.

   

7. Füllen Sie die Parameter DATABASENAME, ANALYSISSERVER und REFRESHTYPE aus, und klicken Sie dann auf OK. Der Parameter WEBHOOKDATA ist nicht erforderlich, wenn das Runbook manuell ausgeführt wird.

   

Wenn das Runbook erfolgreich ausgeführt wurde, erhalten Sie eine Ausgabe ähnlich der folgenden:

Verwenden eines eigenständigen Azure Automation-Runbooks

Das Runbook kann so konfiguriert werden, dass die Aktualisierung des Azure Analysis Services-Modells nach Zeitplan ausgelöst wird.

Dies kann wie folgt konfiguriert werden:

1. Klicken Sie im Automation-Runbook auf Zeitpläne und dann auf Zeitplan hinzufügen.

   

2. Klicken Sie auf Zeitplan>Neuen Zeitplan erstellen, und geben Sie dann die Details ein.

   

3. Klicken Sie auf Erstellen.

4. Füllen Sie die Parameter für den Zeitplan aus. Diese werden jedes Mal verwendet, wenn das Runbook ausgelöst wird. Der Parameter WEBHOOKDATA muss leer bleiben, wenn die Ausführung nach einem Zeitplan erfolgt.

   

5. Klicken Sie auf OK.

Nutzen mit Data Factory

Um das Runbook mithilfe von Azure Data Factory zu nutzen, müssen Sie zunächst einen Webhook für das Runbook erstellen. Der Webhook enthält eine URL, die über eine Azure Data Factory-Webaktivität aufgerufen werden kann.

1. Klicken Sie in Ihrem Automation-Runbook auf Webhooks und dann auf Webhook hinzufügen.

   

2. Geben Sie für den Webhook einen Namen und ein Ablaufdatum an. Mit dem Namen wird der Webhook lediglich im Automation-Runbook identifiziert, er ist kein Bestandteil der URL.

   Achtung

   Kopieren Sie die URL vor dem Schließen des Assistenten. Nach dem Schließen können Sie nicht mehr zurückkehren.

   

   Die Parameter für den Webhook können leer bleiben. Wenn Sie die Azure Data Factory-Webaktivität konfigurieren, können die Parameter in den Text des Webaufrufs übergeben werden.

3. Konfigurieren Sie in Data Factory eine Webaktivität.

Beispiel

Die URL ist die aus dem Webhook erstellte URL.

Der Text ist ein JSON-Dokument, das die folgenden Eigenschaften enthalten muss:

JSON-Beispieltext:

{
    "AnalysisServicesDatabaseName": "AdventureWorksDB",
    "AnalysisServicesServer": "asazure://westeurope.asazure.windows.net/MyAnalysisServer",
    "DatabaseRefreshType": "Full"
}

Diese Parameter werden im PowerShell-Skript des Runbooks definiert. Wenn die Webaktivität ausgeführt wird, wird als JSON-Nutzlast WEBHOOKDATA übergeben.

Dies wird deserialisiert und als PowerShell-Parameter gespeichert, die dann im PowerShell-Befehl Invoke-ProcessASDatabase verwendet werden.

Verwenden eines Hybrid Workers mit Azure Analysis Services

Ein virtueller Azure-Computer mit einer statischen öffentlichen IP-Adresse kann als Azure Automation Hybrid Worker verwendet werden. Diese öffentliche IP-Adresse kann dann der Azure Analysis Services-Firewall hinzugefügt werden.

Erstellen Sie nach dem Konfigurieren eines Hybrid Workers einen Webhook entsprechend der Beschreibung im Abschnitt Nutzen mit Data Factory. Als einzigen Unterschied wählen Sie hier beim Konfigurieren des Webhooks die Option Ausführen auf>Hybrid Worker aus.

Beispielwebhook mithilfe von Hybrid Worker:

PowerShell-Beispielrunbook

Der folgende Codeausschnitt ist ein Beispiel dafür, wie die Aktualisierung des Azure Analysis Services-Modells mit einem PowerShell-Runbook durchgeführt werden kann.

param
(
    [Parameter (Mandatory = $false)]
    [object] $WebhookData,

    [Parameter (Mandatory = $false)]
    [String] $DatabaseName,
    [Parameter (Mandatory = $false)]
    [String] $AnalysisServer,
    [Parameter (Mandatory = $false)]
    [String] $RefreshType
)

$_Credential = Get-AutomationPSCredential -Name "ServicePrincipal"

# If runbook was called from Webhook, WebhookData will not be null.
if ($WebhookData)
{ 
    # Retrieve AAS details from Webhook request body
    $atmParameters = (ConvertFrom-Json -InputObject $WebhookData.RequestBody)
    Write-Output "CredentialName: $($atmParameters.CredentialName)"
    Write-Output "AnalysisServicesDatabaseName: $($atmParameters.AnalysisServicesDatabaseName)"
    Write-Output "AnalysisServicesServer: $($atmParameters.AnalysisServicesServer)"
    Write-Output "DatabaseRefreshType: $($atmParameters.DatabaseRefreshType)"
    
    $_databaseName = $atmParameters.AnalysisServicesDatabaseName
    $_analysisServer = $atmParameters.AnalysisServicesServer
    $_refreshType = $atmParameters.DatabaseRefreshType
 
    Invoke-ProcessASDatabase -DatabaseName $_databaseName -RefreshType $_refreshType -Server $_analysisServer -ServicePrincipal -Credential $_credential
}
else 
{
    Invoke-ProcessASDatabase -DatabaseName $DatabaseName -RefreshType $RefreshType -Server $AnalysisServer -ServicePrincipal -Credential $_Credential
}

Nächste Schritte

Beispiele
REST-API