サンプルの配置前と配置後スクリプト

[アーティクル]
12/09/2023

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータサイエンス、リアルタイム分析、ビジネスインテリジェンス、レポートまで、あらゆるものをカバーしています。無料で新しい試用版を開始する方法について説明します。

次のサンプルでは、Azure Data Factory 内で継続的インテグレーションおよびデリバリーを使用したデプロイ前と後のスクリプトを使用する方法を示します。

Azure PowerShell をインストールする

Azure PowerShell のインストールと構成の方法に関するページの手順に従って、最新の Azure PowerShell モジュールをインストールしてください。

警告

ADO タスクで PowerShell Core を使用してスクリプトを実行してください

デプロイ前と後のスクリプト

リリースプロセス (CICD) 中にトリガーを停止または開始し、グローバルパラメーターを更新するサンプルスクリプトは、Azure Data Factory の公式の GitHub ページにあります。

注意

CI/CD 中にすべてのトリガーをオフ/オンにするのではなく、変更されたトリガーのみをオフ/オンにする場合は、PrePostDeploymentScript.Ver2.ps1 を使用します。

スクリプトの実行とパラメーター

次のサンプルスクリプトは、トリガーをデプロイ前に停止し、デプロイ後に再起動するために使用できます。このスクリプトには、削除済みのリソースを完全に削除するコードも含まれています。 Azure DevOps の git リポジトリにスクリプトを保存し、Azure PowerShell タスク、最新の Azure PowerShell バージョンを介して参照します。

デプロイ前スクリプトを実行する場合は、[スクリプトの引数] フィールドで、次のパラメーターのバリエーションを指定する必要があります。

-armTemplate "$(System.DefaultWorkingDirectory)/<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $true -deleteDeployment $false

デプロイ後スクリプトを実行する場合は、[スクリプトの引数] フィールドで、次のパラメーターのバリエーションを指定する必要があります。

Note

-deleteDeployment フラグは、ARM のデプロイ履歴から ADF デプロイエントリを削除することを指定するために使用されます。

Azure PowerShell task

スクリプトの実行とパラメーター - YAML パイプライン

次の YAML コードでは、トリガーをデプロイ前に停止し、その後再起動するために使用できるスクリプトを実行します。このスクリプトには、削除済みのリソースを完全に削除するコードも含まれています。新しい CI/CD フローに関する記事で説明されている手順に従っている場合、このスクリプトは npm 発行パッケージを介して作成された成果物の一部としてエクスポートされます。

ADF トリガーを停止する

 - task: AzurePowerShell@5
            displayName: Stop ADF Triggers
            inputs:
              scriptType: 'FilePath'
              ConnectedServiceNameARM: AzureDevServiceConnection
              scriptPath: ../ADFTemplates/PrePostDeploymentScript.ps1
              ScriptArguments: -armTemplate "<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name> -predeployment $true -deleteDeployment $false
              errorActionPreference: stop
              FailOnStandardError: False
              azurePowerShellVersion: 'LatestVersion'
              pwsh: True
              workingDirectory: ../

ADF トリガーを開始する

          - task: AzurePowerShell@5
            displayName: Start ADF Triggers
            inputs:
              scriptType: 'FilePath'
              ConnectedServiceNameARM: AzureDevServiceConnection
              scriptPath: ../ADFTemplates/PrePostDeploymentScript.ps1
              ScriptArguments: -armTemplate "<your-arm-template-location>" -ResourceGroupName <your-resource-group-name> -DataFactoryName <your-data-factory-name>-predeployment $false -deleteDeployment $true
              errorActionPreference: stop
              FailOnStandardError: False
              azurePowerShellVersion: 'LatestVersion'
              pwsh: True
              workingDirectory: ../