Schedule トリガーを使用すると、特定の間隔で定期的に統合を実行できます。このトリガーは、手動による介入を行うことなく自動的に統合を実行する場合に有用です。たとえば、次のようなタイプのタスクで Schedule トリガーの使用を検討できます。
- ファイルをあるシステムから別のシステムへ定期的にアップロードする
- メール通知を定期的に送信する
- データベースを定期的に同期する
始める前に
Google Cloud プロジェクトの Apigee サービス エージェント(
service-PROJECT_ID
@gcp-sa-apigee.iam.gserviceaccount.com
)に Apigee Integration の起動元 IAM ロールが割り当てられていることを確認します。
IAM ロールの割り当ての詳細については、Google Cloud でのアクセスの管理をご覧ください。
Schedule トリガーを追加する
新規または既存の統合に Schedule トリガーを追加する手順は次のとおりです。- Apigee UI で、Apigee 組織を選択します。
- [Develop] > [Integrations] の順にクリックします。
- 既存のインテグレーションを選択するか、[Create Integration] をクリックして新しいインテグレーションを作成します。
新しいインテグレーションを作成する場合:
- [Create Integration] ダイアログで名前と説明を入力します。
- サポートされているリージョンのリストから、インテグレーションのリージョンを選択します。
- [Create] をクリックします。
統合デザイナーで統合が開きます。
- 統合デザイナーのナビゲーション バーで、[+Add a task/trigger] > [Triggers] をクリックして、使用できるトリガーのリストを表示します。
- [Schedule trigger] 要素をクリックして、デザイナーに配置します。
Schedule トリガーを構成する
統合エディタの [Schedule trigger] 要素をクリックして、トリガー構成ペインを表示します。
[Schedule trigger] は、次のいずれかのモードを使用して構成できます。
- Basic: 実行頻度を構成するユーザー インターフェースを提供します。
- Advanced: cron 式を使用して実行頻度を構成します。
Basic モードでは、統合を実行する時刻または時間間隔を選択できます。特定の時刻に統合を実行する場合は、[時刻] プルダウンから [Run at a specific time] を選択して、次のプロパティを設定します。
- 時刻: 統合を実行する時刻(24 時間表示)。
- 曜日: 統合を実行する曜日。毎日、特定の曜日、月の特定の日などにデータ統合を実行するように選択できます。
- 月: 統合を実行する月。統合を毎月実行するか、特定の月を選択できます。
[詳細設定] モードでは、cron 式を使用して実行頻度を指定できます。cron 式には、次の順序で 5 つの値を指定する必要があります。
- 分(0~59)
- 時間(0~23)
- 日(1~31)
- 月(次のいずれかの値)
- 数字(1~12)
- 月の 3 文字の省略形(例: Jan、Feb、Mar)
- 曜日(次のいずれかの値)
- 日曜日を 0 とする 0~6 の数値
- 曜日の 3 文字の省略形(例: Mon、Tue、Wed)
たとえば、毎月 1 日に統合を実行するには、* * 1 * *
という cron 式を使用します。
おすすめの方法
[Schedule trigger] が不要になった場合は、無効にすることをおすすめします。冗長な [Schedule trigger] を有効にしておくと、統合が自動的にトリガーされ続けます。
[Schedule trigger] を無効にするには、次のいずれかを行います。
- [Schedule trigger] を含む統合の公開を停止する。統合はもはや有効ではなくなり、トリガーは実行されなくなります。
- [Schedule trigger] を別のトリガーに置き換えて、統合を再公開する。再公開されたアクティブなバージョンの統合では、[Schedule trigger] は使用されません。
- 現在のバージョンの統合を削除する。統合名の横にあるバージョン リストの [削除] オプションを使用します。
割り当てと上限
割り当てと上限については、割り当てと上限をご覧ください。
次のステップ
- すべてのタスクとトリガーを確認する。
- インテグレーションをテストして公開する方法を確認する。
- エラー処理について確認する。
- 統合実行ログについて確認する。