Google Cloud Run関数をデータベース内のSQL関数として起動するステップを示します。

1. Autonomous DatabaseインスタンスからGoogle Cloud Run関数にアクセスするには、Googleサービス・アカウントを使用します。Google Cloud Platform (GCP)アプリケーションのGoogleサービス・アカウントに、cloudfunctions.functions.list権限およびCloud Functions InvokerロールとCloud Run Invokerロールを付与する必要があります。
   詳細は、次を参照してください:

   • Googleサービス・アカウントを使用したGoogle Cloudリソースへのアクセスについて

   • IAM(第1世代)によるアクセスの承認

   • IAMによるアクセスの認可

2. カタログを作成します。ADMIN以外のユーザーを使用してGoogle Cloud Runファンクションのカタログを作成するには、そのユーザーにCLOUD_INTEGRATIONSビューに対する読取り権限を付与する必要があります。

   カタログは、APIエンドポイントを使用してそれぞれのクラウド・ファンクションを参照およびコールするラッパー・ファンクションのコレクションです。

   BEGIN
       DBMS_CLOUD_FUNCTION.CREATE_CATALOG (
           credential_name  => 'GCP$PA', 
           catalog_name     => 'GCP_DEMO_CATALOG', 
           service_provider => 'GCP',
           cloud_params     => '{"project_id":"example_XXXXXX"}'
    );
   END;
   /
   

   cloud_paramsのproject_id値は、Google Cloud Platform (GCP)のプロジェクトIDです。

   これにより、GCP_DEMO_CATALOGカタログが作成され、指定されたproject_idのすべての関数がカタログ化されます。

   詳細は、CREATE_CATALOGプロシージャを参照してください。DBA_CLOUD_FUNCTION_CATALOGビューおよびUSER_CLOUD_FUNCTION_CATALOGビュー・ビューを問い合せて、データベース内のすべてのカタログのリストを取得できます。

3. カタログ内の関数のリストを表示します。

   次に、Google Cloud Run関数をリストする例を示します。

   VAR function_list CLOB;
   
   BEGIN
       DBMS_CLOUD_FUNCTION.LIST_FUNCTIONS (
           credential_name  => 'GCP$PA',
           catalog_name     => 'GCP_DEMO_CATALOG',
           function_list    => :function_list
    );
   END;
   /
   
   SELECT JSON_QUERY (:function_list, '$' RETURNING VARCHAR2(32676) pretty) AS search_results FROM dual;
   

   詳細は、LIST_FUNCTIONSプロシージャを参照してください。

4. DBMS_CLOUD_FUNCTION.SYNC_FUNCTIONSを実行してラッパーSQL関数を作成します。次のいずれかの方法を使用して、それぞれのクラウド関数をコールするラッパーSQL関数をカタログ内に作成できます。

   • SYNC_FUNCTIONS: ラッパーSQLファンクションを作成するSYNC_FUNCTIONSメソッドは、カタログ内のラッパー・ファンクションを自動的に同期(作成または削除)し、カタログが作成されたリージョン、コンパートメントおよびテナンシで定義されたクラウド・ファンクションの完全なリストを表示します。たとえば:

   
   BEGIN
       DBMS_CLOUD_FUNCTION.SYNC_FUNCTIONS (
           catalog_name => 'GCP_DEMO_CATALOG'
    );
   END;
   /
   

   これにより、カタログに新しいファンクションを追加したり、カタログから削除されたファンクションのラッパーを削除するためのPL/SQLラッパーが作成されます。

   次の問合せを実行して、同期を確認します。

   
   SELECT object_name FROM sys.all_objects WHERE owner='TEST_USER' AND object_type='FUNCTION';
   

   ノート
   
   このコマンドを実行するには、現在のユーザーをノートにとります。

   詳細は、SYNC_FUNCTIONSプロシージャを参照してください。

   • DBMS_CLOUD.CREATE_FUNCTIONを使用して、それぞれのクラウド関数をコールするSQL関数をカタログに手動で作成できます。

   GCP_DEMO_CATALOGカタログにファンクションを作成する例。

   EXEC :function_args  := TO_CLOB('{"name": "VARCHAR2"}');

   BEGIN
       DBMS_CLOUD_FUNCTION.CREATE_FUNCTION (
           credential_name => 'GCP$PA',
           catalog_name    => 'GCP_DEMO_CATALOG',
           function_name   => 'gcp_testfunc',
           function_id     => 'function_id_path',
           input_args      => :function_args
    );
   END;
   /
   

   これにより、GCP_DEMO_CATALOGカタログにGCP_TESTFUNC関数が作成されます。

   カタログのGCP_TESTFUNC関数は、FUNCTION_IDパラメータによってプロジェクトIDが参照されるそれぞれのGoogle Cloud Run関数への参照です。カタログ内の関数とその引数を呼び出すと、対応するGoogle Cloud Run関数が実行され、関数によって返される出力が提供されます。

   DBA_CLOUD_FUNCTIONビューおよびUSER_CLOUD_FUNCTIONビュー・ビューを問い合せて、データベース内のすべての関数のリストを取得できます。

   詳細は、CREATE_FUNCTIONプロシージャを参照してください。

5. ファンクションの作成後、DESCRIBEを実行して起動できます。

   DESC GCP_TESTFUNC
   COLUMN STATUS format a30
   COLUMN OUTPUT format a30

   SELECT GCP_TESTFUNC(NULL) FROM dual;

   これにより、function_idパラメータで指定された関数参照をコールして、GCP_TESTFUNC関数が起動されます。

6. 既存のファンクションは、DROP_FUNCTIONプロシージャを使用して削除できます。たとえば:

   EXEC DBMS_CLOUD_FUNCTION.DROP_FUNCTION (CATALOG_NAME => 'GCP_DEMO_CATALOG', FUNCTION_NAME => 'GCP_TESTFUNC');
   

   これにより、GCP_DEMO_CATALOGカタログからGCP_TESTFUNC関数が削除されます。

   詳細は、DROP_FUNCTIONプロシージャを参照してください。

7. 既存のカタログは、DROP_CATALOGプロシージャを使用して削除できます。たとえば:

   BEGIN
       DBMS_CLOUD_FUNCTION.DROP_CATALOG (
           catalog_name     => 'GCP_DEMO_CATALOG'
    );
   END;
   /

   これにより、データベースからGCP_DEMO_CATALOGが削除されます。

   詳細は、DROP_CATALOGプロシージャを参照してください。