Autonomous DatabaseからSlack通知を送信

Autonomous DatabaseからSlackチャネルに問合せのメッセージ、アラートまたは出力を送信できるようにSlackを構成する方法について説明します。また、Slack通知の送信に使用する手順についても説明します。

Autonomous DatabaseからSlack通知を送信する準備
Slack通知を送信するには、Autonomous Databaseからのメッセージを受信するようにSlackアプリケーションを構成する必要があります。次に、DBMS_CLOUD_NOTIFICATIONプロシージャとともに使用する資格証明を作成して、Autonomous DatabaseからSlack通知を送信します。
Slackチャネルへのメッセージの送信
問合せ結果をSlackチャネルに送信

親トピック: Autonomous Databaseで電子メールと通知を送信

Autonomous DatabaseからSlack通知を送信する準備

Slack通知を送信するには、Autonomous Databaseからのメッセージを受信するようにSlackアプリケーションを構成する必要があります。次に、DBMS_CLOUD_NOTIFICATIONプロシージャとともに使用する資格証明を作成して、Autonomous DatabaseからSlack通知を送信します。

DBMS_CLOUD_NOTIFICATIONプロシージャでSlackを使用するには:

Slackアプリケーションを作成します。
SlackアプリケーションはSlackワークスペースにインストールされ、これにはメッセージを送信できるチャネルがあります。 Slackアプリケーションのボット・トークンには、次の権限スコープが定義されている必要があります:
```
channels:read
chat:write
files:write
```
Slackアプリケーションの設定の詳細は、「アプリケーションの作成」を参照してください。
Slack管理者に、DBMS_CLOUD_NOTIFICATIONがチャネルの「統合」オプションを使用してメッセージを送信できるチャネルに、Slackアプリケーションを追加します。

詳細については、「基本的なアプリケーション設定」を参照してください。
Slackアプリケーション固有のページにあるhttps://app.slack.comの下にある、アプリケーションのボット・トークンを見つけます。

詳細については、「基本的なアプリケーション設定」を参照してください。
Autonomous DatabaseからSlackアプリケーションにアクセスするための資格証明オブジェクトを作成します。

ヒント:
CREATE_CREDENTIALプロシージャを正常に使用できない場合は、ADMINユーザーに問い合せて、DBMS_CLOUDパッケージに対する実行アクセス権を付与します。
資格証明ユーザー名はSLACK_TOKENで、パスワードはボット・トークンです。

たとえば:
```
BEGIN
   DBMS_CLOUD.CREATE_CREDENTIAL(
     credential_name => 'SLACK_CRED',
     username    => 'SLACK_TOKEN',
     password    => 'xoxb-34....96-34....52-zW....cy');
END;
/
```
詳細については、「CREATE_CREDENTIALプロシージャ」を参照してください。

外部ネットワーク・サービス(Slack)へのユーザー・アクセスを許可するようにアクセス制御を構成します。

BEGIN
 DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE (
  host         => 'slack.com', 
  lower_port   => 443,
  upper_port   => 443,
  ace          => xs$ace_type(
      privilege_list => xs$name_list('http'),
      principal_name => example_invoking_user, 
      principal_type => xs_acl.ptype_db)); 
END;

詳細については、「外部ネットワーク・サービスのアクセス制御の構成」を参照してください。

SQLを送信する場合は、DBMS_CLOUD_NOTIFICATION.SEND_DATAを使用して出力を送信できるようにアクセス制御を構成します。

BEGIN
 DBMS_NETWORK_ACL_ADMIN.APPEND_HOST_ACE (
  host         => 'files.slack.com', 
  lower_port   => 443,
  upper_port   => 443,
  ace          => xs$ace_type(
      privilege_list => xs$name_list('http'),
      principal_name => example_invoking_user, 
      principal_type => xs_acl.ptype_db)); 
END;

詳細については、「外部ネットワーク・サービスのアクセス制御の構成」を参照してください。

親トピック: Autonomous DatabaseからSlack通知を送信

Slackチャネルへのメッセージの送信

「Autonomous DatabaseからSlack通知を送信する準備」の説明に従ってSlack資格証明オブジェクトを作成した後、DBMS_CLOUD_NOTIFICATION.SEND_MESSAGEプロシージャを使用して、Slackチャネルにメッセージを送信できます。

例:

BEGIN
   DBMS_CLOUD_NOTIFICATION.SEND_MESSAGE(
      provider          => 'slack',
      credential_name   => 'SLACK_CRED',
      message           => 'Alert from Autonomous Database...',
      params            => json_object('channel' value 'C0....08'));
END;
/

paramsパラメータを使用して、Slackチャネルを指定します。

channel: チャネルIDを指定します。

チャネルIDはチャネルの一意のIDで、チャネル名とは異なります。 Slackでは、チャネルの詳細を表示するときに、「情報」タブでチャネルIDを確認できます。詳細については、「SlackチームIDおよびSlackチャネルIDの検索方法」を参照してください。

詳細については、「SEND_MESSAGEプロシージャ」を参照してください。

親トピック: Autonomous DatabaseからSlack通知を送信

問合せ結果をSlackチャネルに送信

「Autonomous DatabaseからSlack通知を送信する準備」の説明に従ってSlack資格証明オブジェクトを作成した後、DBMS_CLOUD_NOTIFICATION.SEND_DATAプロシージャを使用して、問合せの出力をSlackチャネルに送信できます。

例:

BEGIN
  DBMS_CLOUD_NOTIFICATION.SEND_DATA(
      provider => 'slack',
      credential_name => 'SLACK_CRED',
      query => 'SELECT username, account_status, expiry_date FROM USER_USERS WHERE rownum < 5',
      params => json_object('channel' value 'C0....08',
                            'type' value 'csv'));
END;
/

paramsパラメータを使用して、Slackチャネルおよびデータ型を指定します:

channel: チャネルIDを指定します。

チャネルIDはチャネルの一意のIDで、チャネル名とは異なります。 Slackでは、チャネルの詳細を表示するときに、「情報」タブでチャネルIDを確認できます。詳細については、「SlackチームIDおよびSlackチャネルIDの検索方法」を参照してください。
type: 出力タイプを指定します。有効な値は次のとおりです: ' csv 'または' json '。

詳細については、「SEND_DATAプロシージャ」を参照してください。

関連トピック

SEND_DATAプロシージャ

親トピック: Autonomous DatabaseからSlack通知を送信