はじめに

SQLでAutonomous Databaseのステータス（AVAILABLE、STOPPED、STARTING、UPDATING等）が確認できると何かと便利なので、指定したAutonomous Databaseのステータスを返すストアド・ファンクションを作成してみました。

Autonomous DatabaseがあるリージョンとAutonomous DatabaseのOCIDを引数として渡すと、指定されたAutonoumos Databaseのステータス（Lifecycle State）を返すファンクションget_adb_stateを作成します。
ここではAPIアクセスの認証にAutonomous Databaseのリソース・プリンシパルを使用しています。

get_adb_state Function

CREATE OR REPLACE FUNCTION get_adb_state ( adb_region IN VARCHAR2, adb_ocid IN VARCHAR2)
  RETURN VARCHAR2
  IS
    request_uri    VARCHAR2(300);
    resp           DBMS_CLOUD_TYPES.resp;
  
  BEGIN
-- 指定したAutonomous Databaseの情報を取得するAPIをコールするためのURIの生成
    request_uri := 'https://database.'||adb_region||'.oraclecloud.com/20160918/autonomousDatabases/'||adb_ocid;
-- Autonomous Databaseの情報を取得するAPIをコール
    resp := DBMS_CLOUD.SEND_REQUEST(
                credential_name => 'OCI$RESOURCE_PRINCIPAL',
                uri => request_uri,
                method => DBMS_CLOUD.METHOD_GET
            );
-- 取得したAutonomous Databaseの情報内のlifecycleStateの値を戻す
    RETURN json_value(DBMS_CLOUD.GET_RESPONSE_TEXT(resp), '$.lifecycleState');
  END;
/

SQL*Plusから作成してみます。

SQL> CREATE OR REPLACE FUNCTION get_adb_state ( adb_region IN VARCHAR2, adb_ocid IN VARCHAR2)
  2    RETURN VARCHAR2
  3    IS
  4      request_uri    VARCHAR2(300);
  5      resp           DBMS_CLOUD_TYPES.resp;
  6    BEGIN
  7      request_uri := 'https://database.'||adb_region||'.oraclecloud.com/20160918/autonomousDatabases/'||adb_ocid;
  8      resp := DBMS_CLOUD.SEND_REQUEST(
  9                  credential_name => 'OCI$RESOURCE_PRINCIPAL',
 10                  uri => request_uri,
 11                  method => DBMS_CLOUD.METHOD_GET
 12              );
 13      RETURN json_value(DBMS_CLOUD.GET_RESPONSE_TEXT(resp), '$.lifecycleState');
 14    END;
 15  /

ファンクションが作成されました。

SQL>

問題なく作成できましたので、早速実行してみます。
get_adb_stateファンクションにAutonomous DatabaseがあるリージョンとAutonomous DatabaseのOCIDを渡して実行してみました。
ここではap-osaka-1（=大阪リージョン）と大阪リージョンにあるAutonomous DatabaseのOCIDを指定しています。

SQL> select get_adb_state('ap-osaka-1','ocid1.autonomousdatabase.oc1.ap-osaka-1.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx') adb_state from dual;

ADB_STATE
--------------------------------------------------------------------------------
AVAILABLE

SQL>

ステータスが「AVAILABLE」であることがわかりました。

コンソールでAutonomous Databaseのステータスを確認してみます。

「使用可能」であることが確認できました。

こちらのAutonomous Databaseを停止して、get_adb_stateファンクションの結果が変化するかを確認してみます。

コンソールで「停止中」となっている状態では、get_adb_stateファンクションの結果が「STOPPING」になりました。

SQL> select get_adb_state('ap-osaka-1','ocid1.autonomousdatabase.oc1.ap-osaka-1.anvwsljrssl65iqauegw5yxqxprruyhckxfs5atzsitj5xjgrz4e4q4b5pia') adb_state from dual;

ADB_STATE
--------------------------------------------------------------------------------
STOPPING

SQL>

停止済みになるのを待ちます。

コンソールで「停止済」となっている状態では、get_adb_stateファンクションの結果が「STOPPED」になりました。

SQL> select get_adb_state('ap-osaka-1','ocid1.autonomousdatabase.oc1.ap-osaka-1.anvwsljrssl65iqauegw5yxqxprruyhckxfs5atzsitj5xjgrz4e4q4b5pia') adb_state from dual;

ADB_STATE
--------------------------------------------------------------------------------
STOPPED

SQL>

こちらのAutonomous Databaseを起動します。

コンソールで「起動中」となっている状態では、get_adb_stateファンクションの結果が「STARTING」になりました。

SQL> select get_adb_state('ap-osaka-1','ocid1.autonomousdatabase.oc1.ap-osaka-1.anvwsljrssl65iqauegw5yxqxprruyhckxfs5atzsitj5xjgrz4e4q4b5pia') adb_state from dual;

ADB_STATE
--------------------------------------------------------------------------------
STARTING

SQL>

Autonomous Databaseが使用可能になるのを待ちます。

get_adb_stateファンクションの結果が「STARTING」に戻りました。

SQL> select get_adb_state('ap-osaka-1','ocid1.autonomousdatabase.oc1.ap-osaka-1.anvwsljrssl65iqauegw5yxqxprruyhckxfs5atzsitj5xjgrz4e4q4b5pia') adb_state from dual;

ADB_STATE
--------------------------------------------------------------------------------
AVAILABLE

SQL>

こちらのAutonomous Databaseはリフレッシュ可能クローンなので、リフレッシュを実行してみます。
リフレッシュ中はコンソールでは「更新中」と表示されます。

コンソールで「更新中」となっている状態では、get_adb_stateファンクションの結果が「UPDATING」になりました。

SQL> select get_adb_state('ap-osaka-1','ocid1.autonomousdatabase.oc1.ap-osaka-1.anvwsljrssl65iqauegw5yxqxprruyhckxfs5atzsitj5xjgrz4e4q4b5pia') adb_state from dual;

ADB_STATE
--------------------------------------------------------------------------------
UPDATING

SQL>

まとめ

指定したAutonomous Databaseの状態（Lifecycle State）を返すストアド・ファンクションを作成できました。
めでたし、めでたし。

参考資料

・API Reference and Endpoints：Database Service API
・API Reference and Endpoints：GetAutonomousDatabase
・DBMS_CLOUD.SEND_REQUEST
・DBMS_CLOUD.GET_RESPONSE_TEXT