Dataphin は、Alibaba Cloud ショートメッセージサービスとカスタムテキストメッセージチャネルの構成をサポートしています。このトピックでは、テキストメッセージ送信チャネルを設定する方法について説明します。
使用方法
メッセージ送信チャネルは、インスタンスレベルでグローバルに、またはテナントごとに構成できます。組織のニーズに合わせて構成してください。
メッセージチャネルが無効になっている場合、構成済みのアラートメッセージは送信されません。アラートメッセージをスムーズに配信するために、テキストメッセージチャネルをアクティブにしてください。
権限に関する説明
メタデータウェアハウス テナント スーパー管理者とインスタンスレベルのシステム管理者は、メッセージチャネルを変更する権限を持っています。
テナントレベルでは、スーパー管理者とシステム管理者はメッセージチャネルを編集できますが、他のユーザーは表示することしかできません。
ショートメッセージサービスを構成する
デフォルトでは、[システム設定] は、デプロイメントファイルの構成情報を使用してテキストメッセージを送信します。まだ構成されていない場合は、カスタム構成を使用してください。
Dataphin ホームページで、トップメニューバーから [管理センター] > [システム設定] を選択します。
左側のメニューバーで、[システム設定] > [メッセージチャネル] を選択します。
[メッセージチャネル設定] ページで、[テキストメッセージ] タブをクリックします。
[チャネル設定] を選択し、[テナントカスタム] を選択した後、[音声サービス] を選択します。異なる音声サービスでは、以下の表に詳述するように、異なるパラメーターが必要です。
Alibaba Cloud ショートメッセージサービス
パラメーターの構成
パラメーター
説明
リージョン
リージョンを選択します。
AccessKey ID
AccessKey ID を入力します。新しく作成するには、[accesskey を作成] をクリックします。
AccessKey Secret
AccessKey Secret を入力します。[接続テスト] をクリックします。
成功した場合、接続テストに合格したことを示すメッセージが表示されます。
失敗した場合、接続テストは失敗しました。入力した AccessKey ID と AccessKey Secret が正しいかどうかを確認してください。
署名
ドロップダウンボックスから署名を選択します。作成するには、[署名を作成] ボタンをクリックします。
テンプレートの構成
テンプレートをすばやく作成するには、[ワンクリック作成] ボタンをクリックします。
説明作成後、テンプレート名と ID は自動的に次のテンプレート選択入力ボックスにバックフィルされます。
テンプレートを作成するときに同じ名前のテンプレートが既に存在する場合、同じ名前のテンプレートは作成されません。テンプレートを選択するか、手動でテンプレートを作成できます。
Dataservice Studio、Data Quality、リアルタイムタスクアラート、オフラインタスクアラート、タスクインスタンスが生成されない、ベースラインタスクエラー、ベースラインタスクの減速、ベースライン警告、ベースラインの中断
ドロップダウンボックスからテンプレートを選択します。[テンプレートを作成] ボタンをクリックします。
説明作成後、作成されたテンプレートは自動的にテンプレート入力ボックスにバックフィルされます。
テンプレートを作成するときに同じ名前のテンプレートが既に存在する場合、同じ名前のテンプレートは作成されません。テンプレートを選択するか、手動でテンプレートを作成できます。
テストメッセージを送信する
[テストメッセージを送信] をクリックして、Alibaba Cloud ショートメッセージサービス が正しく構成されているかどうかを確認します。
パラメーター
説明
受信電話番号
電話番号を入力します。数字のみがサポートされています。
Dataservice Studio、Data Quality、リアルタイムタスクアラート、オフラインタスクアラート、タスクインスタンスが生成されない、ベースラインタスクエラー、ベースラインタスクの減速、ベースライン警告、ベースラインの中断
テキストボックスには固定メッセージの内容が含まれており、編集できません。
重要メッセージの内容はデモ用です。構成されたメッセージテンプレートの内容が変更された場合、変数の置き換えのみが実行され、構成されたテンプレートに従って送信されます。
少なくとも 1 つのメッセージを選択する必要があります。
各テストメッセージは 1 つのテキストメッセージを送信します。
カスタムショートメッセージサービス
説明カスタムショートメッセージサービスを使用する場合、通知設定 でテキストメッセージ通知を有効にできます。
通知を有効にした後、カスタムショートメッセージサービスから Alibaba Cloud ショートメッセージサービスに切り替えると、内部通知はテキストメッセージチャネルを介して送信されなくなります。
送信情報の設定
パラメーター
説明
情報送信 URL
情報送信用の URL アドレス。
リクエストメソッド
システムは POST または GET の選択をサポートしています。
説明POST を選択すると、リクエストパラメーター構成は ヘッダー、パラメーター、および 本文 をサポートします。
GET を選択すると、リクエストパラメーター構成は ヘッダー と パラメーター をサポートします。
リクエストパラメーター構成
ヘッダー: [+ 新規] ボタンをクリックして、ヘッダー パラメーターを構成します。
キー: カスタムキー値。キー値は重複できず、パラメーター名はすべてのパラメーターの中で一意です。
値: 定数と組み込みパラメーターを含むカスタム入力をサポートします。詳細については、「カスタムメッセージチャネルでサポートされるメタデータ」をご参照ください。
タイプ: ドロップダウンボックスでは、文字列、倍精度浮動小数点数、長整数、または ブール値 を選択できます。
パラメーターの暗号化: デフォルトでは無効になっています。暗号化が有効になっている場合、パラメーター値は ****** として表示されます。
重要パラメーターの暗号化は、ヘッダーと本文の定数パラメーター値に対して構成できます。変数パラメーター値は暗号化できません。
暗号化は、Dataphin 編集中の機密化とストレージ中の暗号化のためだけにあります。チャネル統合中は、プレーンテキストで送信されます。暗号化された送信が必要な場合は、構成中に暗号化されたテキストを使用する必要があり、チャネルアプリケーション処理中に復号する必要があります。
パラメーター: [+ 新規] ボタンをクリックして、パラメーター パラメーターを構成します。
キー: カスタムキー値。キー値は重複できず、パラメーター名はすべてのパラメーターの中で一意です。
値: 値 を選択します。定数と組み込みパラメーターを含むカスタム入力をサポートします。詳細については、「カスタムメッセージチャネルでサポートされるメタデータ」をご参照ください。
アクション:
パラメーター パラメーターを編集するには、アクション 列の下にあるアイコン
をクリックします。パラメーター パラメーターを削除するには、アクション 列の下にあるアイコン
をクリックします。
本文: [+ 新規] ボタンをクリックして、本文 パラメーターを構成します。
キー: カスタムキー値。キー値は重複できず、パラメーター名はすべてのパラメーターの中で一意です。
値: 定数と組み込みパラメーターを含むカスタム入力をサポートします。詳細については、「カスタムメッセージチャネルでサポートされるメタデータ」をご参照ください。
タイプ: ドロップダウンボックスでは、文字列、倍精度浮動小数点数、長整数、ブール値、または JSON を選択できます。
パラメーターの暗号化: デフォルトでは無効になっています。暗号化が有効になっている場合、パラメーター値は ****** として表示されます。
アクション:
本文 パラメーターを編集するには、アクション 列の下にあるアイコン
をクリックします。本文 パラメーターを削除するには、アクション 列の下にあるアイコン
をクリックします。
テスト: [テスト] をクリックします。[テストリクエストの送信] ダイアログボックスで、テストパラメーターを構成し、[テストを開始] をクリックします。
リクエストテキストボックスにリクエストの詳細が表示されます。
アイコンをクリックして、リクエストの詳細をコピーできます。リクエスト本文は、Post リクエストメソッドでのみ表示されます。
レスポンステキストボックスにレスポンスの詳細が表示されます。
アイコンをクリックして、レスポンスの詳細をコピーできます。
説明ヘッダー自体にパラメーターが含まれている場合、テスト中にパラメーターの構成値を入力する必要があります。
送信結果の分析
システムは HTTP 状態コードに基づく または HTTP 状態コードと応答結果に基づく をサポートしています。
HTTP 状態コードによる: 状態コードが 2xx の場合、送信は成功したと見なされます。
HTTP 状態コードと応答結果に基づく: 送信条件のカスタム構成。
クエリ結果の分析
キー: ドロップダウンボックスからキー値を選択するか、キー値をカスタマイズできます。
値: カスタム値。
説明状態コードが 2xx で、送信成功条件が満たされている場合、成功したと認識されます。
状態コードが 2xx でない場合、失敗したと認識されます。
状態コードが 2xx で、送信失敗条件が満たされている場合、失敗したと認識されます。
その他の条件下では、送信中として認識され、成功または失敗が得られるまでポーリングを続けます。
${response.key} と入力することで、レスポンスのキー値を取得できます。
結果クエリの設定
パラメーター
説明
結果クエリ
デフォルトは 無効 です。有効 にすることもできます。
無効: 無効になっている場合、送信が完了すると、タスクは成功したと見なされます。
有効: 有効になっている場合、送信が完了すると、結果をポーリングしてアラートセンターに表示する必要があります。
結果クエリ URL
結果クエリ用の URL アドレス。
リクエストメソッド
システムは POST または GET の選択をサポートしています。
説明POST を選択すると、リクエストパラメーター構成は ヘッダー、パラメーター、および 本文 をサポートします。
GET を選択すると、リクエストパラメーター構成は ヘッダー と パラメーター をサポートします。
リクエストパラメーター構成
ヘッダー: [+ 新規] ボタンをクリックして、ヘッダー パラメーターを構成します。
キー: カスタムキー値。キー値は重複できず、パラメーター名はすべてのパラメーターの中で一意です。
値: 定数と組み込みパラメーターを含むカスタム入力をサポートします。詳細については、「カスタムメッセージチャネルでサポートされるメタデータ」をご参照ください。
タイプ: ドロップダウンボックスでは、文字列、倍精度浮動小数点数、長整数、または ブール値 を選択できます。
パラメーターの暗号化: デフォルトでは無効になっています。暗号化が有効になっている場合、パラメーター値は ****** として表示されます。
パラメーター: [+ 新規] ボタンをクリックして、パラメーター パラメーターを構成します。
キー: カスタムキー値。キー値は重複できず、パラメーター名はすべてのパラメーターの中で一意です。
値: 値 を選択します。定数と組み込みパラメーターを含むカスタム入力をサポートします。詳細については、「カスタムメッセージチャネルでサポートされるメタデータ」をご参照ください。
アクション:
パラメーター パラメーターを編集するには、アクション 列の下にあるアイコン
をクリックします。パラメーター パラメーターを削除するには、アクション 列の下にあるアイコン
をクリックします。
本文: [+ 新規] ボタンをクリックして、本文 パラメーターを構成します。
キー: カスタムキー値。キー値は重複できず、パラメーター名はすべてのパラメーターの中で一意です。
値: 定数と組み込みパラメーターを含むカスタム入力をサポートします。詳細については、「カスタムメッセージチャネルでサポートされるメタデータ」をご参照ください。
タイプ: ドロップダウンボックスでは、文字列、倍精度浮動小数点数、長整数、ブール値、または JSON を選択できます。
パラメーターの暗号化: デフォルトでは無効になっています。暗号化が有効になっている場合、パラメーター値は ****** として表示されます。
アクション:
本文 パラメーターを編集するには、アクション 列の下にあるアイコン
をクリックします。[本文] パラメーターを削除するには、[アクション] 列の下にあるアイコン
をクリックします。
[テスト]: [テスト] をクリックします。[テストリクエスト送信] ダイアログボックスで、テスト パラメーターを構成し、[テスト開始] をクリックします。
リクエスト テキストボックスには、リクエストの詳細が表示されます。
アイコンをクリックすると、リクエストの詳細をコピーできます。リクエスト本文は、POST リクエスト メソッドでのみ表示されます。
レスポンス テキストボックスには、レスポンスの詳細が表示されます。
アイコンをクリックすると、レスポンスの詳細をコピーできます。
説明ヘッダー自体にパラメーターが含まれている場合は、テスト中にパラメーターの構成値を入力する必要があります。
クエリ結果分析
キー: ドロップダウンボックスからキー値を選択するか、キー値をカスタマイズできます。
値: カスタム値。
説明状態コードが 2xx で、送信成功条件が満たされている場合、成功と認識されます。
状態コードが 2xx でない場合、失敗と認識されます。
状態コードが 2xx で、送信失敗条件が満たされている場合、失敗と認識されます。
その他の条件下では、送信中と認識され、成功または失敗が取得されるまでポーリングが続行されます。
${response.key} を入力することで、応答内のキー値を取得できます。
テストメッセージの送信
[テストメッセージの送信] をクリックして、[カスタム ショートメッセージサービス] が正しく構成されていることを確認します。
パラメーター
説明
受信者
受信者を選択します。
音声メッセージ
デフォルトの入力内容は [this Is A Test Message From Dataphin] です。
128 文字以内で編集をカスタマイズできます。
[保存] をクリックして、Alibaba Cloud ショートメッセージサービスまたはカスタム ショートメッセージ チャネルの構成を完了します。