SQL関数としてAzure関数を起動するステップ

HTTPトリガーを使用してデータベース内のSQL関数としてAzureリモート関数を起動するステップを示します。

SQLファンクションとしてAzureファンクションを起動するには、APIエンドポイントを介してそれぞれのクラウド・ファンクションを参照およびコールするSQLラッパー・ファンクションのカタログを作成します。このカタログを作成する前に、このカタログで参照するために必要なAzure関数を作成したと仮定します。

  1. Azure関数にアクセスするには、Autonomous DatabaseでAzure Service Principalを使用する必要があります。Webサイト・コントリビュータ・ロールを、Azureファンクション・アプリケーションのアクセス制御(IAM)のAzureサービス・プリンシパルに付与する必要があります。
  2. カタログを作成します。

    カタログは、APIエンドポイントを介してそれぞれのクラウド関数を参照および呼び出すラッパー関数のコレクションです。

    Azure関数のカタログを作成する例。

    BEGIN
        DBMS_CLOUD_FUNCTION.CREATE_CATALOG (
            credential_name  => 'AZURE$PA', 
            catalog_name     => 'AZURE_DEMO_CATALOG', 
            service_provider => 'AZURE',
            cloud_params     => '{"subscription_id":"XXXXXXXXXXXXXXXXXXXXXXXX_example"}'
     );
    END;
    /
    

    CLOUD_PARAMSSUBSCRIPTION_ID値は、Azureファンクション・アプリケーションのsubscription_idです。

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

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

  3. カタログ内の関数をリストできます。

    次に、Azure関数をリストする例を示します:

    VAR function_list CLOB;
    
    BEGIN
     DBMS_CLOUD_FUNCTION.LIST_FUNCTIONS (
        credential_name  => 'AZURE$PA',
        catalog_name     => 'AZURE_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: SYNC_FUNCTIONSは、カタログ内のラッパー関数をAzure関数の完全なリストと自動的に同期(作成または削除)する最も迅速で簡単な方法です。たとえば:

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

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

    ノート

    Azureファンクション・アプリケーションでAzureファンクションが追加、削除または無効化された場合、SYNC_FUNCTIONSを実行して、カタログ内の対応するPL/SQLラッパーを更新する必要があります。

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

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

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

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

    • AZURE_DEMO_CATALOGを使用して、それぞれのAzure関数をコールするSQL関数をカタログに手動で作成できます。

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

    BEGIN
    DBMS_CLOUD_FUNCTION.CREATE_FUNCTION (
      credential_name => 'AZURE$PA',
      catalog_name    => 'AZURE_DEMO_CATALOG', 
      function_name   => 'azure_testfunc', 
      function_id     => 'function_id_path',
      input_args      => :function_args
    );
    END;
    /
    
    ノート

    関数名の最大長は100文字に制限されています。

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

    カタログのAZURE_TESTFUNC関数は、FUNCTION_IDパラメータによってサブスクリプションが参照されるそれぞれのAzure関数への参照です。カタログ内の関数とその引数を呼び出すと、対応するAzure関数が実行され、関数によって返される出力が提供されます。

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

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

    詳細は、Azure Functions HTTPトリガーを参照してください。

  5. ファンクションの作成後、DESCRIBEを実行して起動できます。
    DESC AZURE_TESTFUNC
    SELECT AZURE_TESTFUNC(NULL) FROM dual;

    これにより、AZURE_DEMO_CATALOGカタログ内のファンクション参照/subscriptions/44496e556-8ssp-4262-b389-0f15f685c879/resources/ADBStest/providers/Microsoft.Web/sites/AZUREADBS/functions/HttpTrigger_exampleをコールして、AZURE_TESTFUNCファンクションが呼び出されます。

  6. 既存のファンクションは、DROP_FUNCTIONプロシージャを使用して削除できます。たとえば:
    EXEC DBMS_CLOUD_FUNCTION.DROP_FUNCTION (CATALOG_NAME => 'AZURE_DEMO_CATALOG', FUNCTION_NAME => 'AZURE_TESTFUNC');
    
    

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

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

  7. 既存のカタログは、DROP_CATALOGプロシージャを使用して削除できます。たとえば:
    BEGIN
        DBMS_CLOUD_FUNCTION.DROP_CATALOG (
          catalog_name     => 'AZURE_DEMO_CATALOG'
      );
    END;
    /
    

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

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