SQL関数としてAzure関数を起動するステップ
HTTPトリガーを使用してデータベース内のSQL関数としてAzureリモート関数を起動するステップを示します。
SQLファンクションとしてAzureファンクションを起動するには、APIエンドポイントを介してそれぞれのクラウド・ファンクションを参照およびコールするSQLラッパー・ファンクションのカタログを作成します。このカタログを作成する前に、このカタログで参照するために必要なAzure関数を作成したと仮定します。
- Azure関数にアクセスするには、Autonomous DatabaseでAzure Service Principalを使用する必要があります。Webサイト・コントリビュータ・ロールを、Azureファンクション・アプリケーションのアクセス制御(IAM)の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プロシージャを参照してください。
親トピック: ユーザー定義関数の起動