SQL関数としてAzure関数を起動するステップ
HTTPトリガーを使用してAzureリモート関数をデータベースでSQL関数として起動するステップを示します。
Azure FunctionをSQL関数として起動するには、APIエンドポイントを介してそれぞれのクラウド関数を参照およびコールするSQLラッパー関数のカタログを作成します。このカタログを作成する前に、このカタログで参照するために必要なAzure関数が作成されていることを前提としています。
- Azure関数にアクセスするには、Autonomous DatabaseでAzure Service Principalを使用する必要があります。「Webサイト・コントリビュータ」ロールを、「アクセス制御」(IAM)の下のAzureファンクション・アプリケーションのAzureサービス・プリンシパルに付与する必要があります。
- カタログを作成します。
カタログとは、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_PARAMS
のSUBSCRIPTION_ID
値は、Azureファンクション・アプリケーションのsubscription_idです。これにより、
AZURE_DEMO_CATALOG
カタログが作成され、指定されたSUBSCRIPTION_ID
のすべての関数がカタログ化されます。詳細は、CREATE_CATALOGプロシージャを参照してください。DBA_CLOUD_FUNCTION_CATALOGビューおよびUSER_CLOUD_FUNCTION_CATALOGビュー・ビューを問い合せると、データベース内のすべてのカタログのリストを取得できます。
- カタログ内の関数をリストできます。
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プロシージャを参照してください。
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トリガーを参照してください。
-
- ファンクションの作成後、
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
ファンクションが起動されます。 DROP_FUNCTION
プロシージャを使用して、既存のファンクションを削除できます。たとえば:EXEC DBMS_CLOUD_FUNCTION.DROP_FUNCTION (CATALOG_NAME => 'AZURE_DEMO_CATALOG', FUNCTION_NAME => 'AZURE_TESTFUNC');
これにより、
AZURE_DEMO_CATALOG
カタログからAZURE_TESTFUNC
関数が削除されます。詳細は、DROP_FUNCTIONプロシージャを参照してください。
DROP_CATALOG
プロシージャを使用して、既存のカタログを削除できます。たとえば:BEGIN
DBMS_CLOUD_FUNCTION.DROP_CATALOG
( catalog_name => 'AZURE_DEMO_CATALOG' ); END; /これにより、データベースから
AZURE_DEMO_CATALOG
が削除されます。詳細は、DROP_CATALOGプロシージャを参照してください。
親トピック: ユーザー定義関数の起動