Autonomous Database、OCIネイティブSDKの武器にPL/SQLを追加 (2020/10/27)

Autonomous Database、OCIネイティブSDKの武器にPL/SQLを追加 (2020/10/27)

https://blogs.oracle.com/datawarehousing/post/autonomous-database-adds-plsql-to-its-arsenal-of-oci-native-sdks

投稿者：Nilay Panchal | Principal Product Manager


今年の初め、私は Autonomous Database on Shared infrastructure (ADB-S) の新機能を紹介しました。この機能は、独自のサーバーを立ち上げる必要なく、データベース内でスクリプトを実行するだけで、ほとんどのクラウド REST API を呼び出せるようにします。私たちは、さらに一歩進んで、以前の汎用的な DBMS_CLOUD.SEND_REQUEST プロシージャの上に、使い慣れたネイティブな OCI PL/SQL SDK を構築しました。これにより、Oracle Cloud Infrastructure（OCI）用のネイティブSDKの長いリストにPL/SQLが追加されました。


このSDKを使えば、データベーススクリプトと同じように、OCI REST APIを呼び出すPL/SQLプロシージャを呼び出すことができます。Object Storageのデータ作成・管理、仮想マシンやAutonomous Databaseのスピンアップ、サーバーレスOracle Functionsの呼び出し、Data Streamsの管理など、データパイプラインやビジネスロジックの一部を統合できるため、強力です。


SQL Developer の Web ワークシートに飛び込んで、これがどのように実行されるかを見てみましょ う。以下の例では、データを保持するバケットをオブジェクトストアに作成し、後でOracle Functionを呼び出すという、シンプルなPL/SQLプロシージャを使用しています。


まだAutonomous Databaseを作成していない場合は、クイックスタートチュートリアルのLab 1に従ってください。数分しかかかりません!



ネイティブの OCI クレデンシャルを作成


OCI REST API への安全な呼び出しを許可するためには、まず、公開鍵と秘密鍵を使用してネイティブ OCI クレデンシャルを作成する必要があります。もし、クレデンシャルの作成に慣れていない場合は、私の同僚であるCanの簡単なガイドに従って、安全なアクセスのOCIクレデンシャルを作成してください。ここでは、OCI ネイティブクレデンシャル "SDK_CRED" を作成します。

begin
  DBMS_CLOUD.CREATE_CREDENTIAL (
    credential_name => 'SDK_CRED',
    user_ocid       => 'ocid1.user.oc1....',
    tenancy_ocid    => 'ocid1.tenancy.oc1....',
    private_key     => 'MIIE.....',
    fingerprint     => 'f2:db:d9:18:a4:aa:fc:83:f4:f6:6c:39:96:16:aa:27'
  );
end;
/



OCI Object Storage に関連する DBMS_CLOUD_OCI_* PL/SQL SDK パッケージを呼び出し


OCI REST API上でこのSDKを使用する場合、コードのブロックの一般的なガイドラインは次のようになります。

  1.     REST API 呼び出しを実行したい OCI リソースに関連する、指定された SDK パッケージを特定します。
  2.     パッケージで定義された応答オブジェクトと、応答オブジェクトの型定義で指定された型を持つ対応する応答本文オブジェクトを宣言します。
  3.     SDK 関数の呼び出しとともに送信する必要のあるリクエストオブジェクトとそのパラメータを宣言し、設定します (以下の例では、"bucketdetails" を設定する必要があります)。
  4.     実行したいアクションに対応するSDK関数を呼び出し、必要なパラメータを渡します。Step 3 で作成したリクエストオブジェクトは、ここで渡します。
  5.     レスポンスオブジェクトを設定して、SDK関数の呼び出しからレスポンスを取得します。このレスポンスオブジェクトに、関数呼び出しのステータスとレスポンス情報を問い合わせます。


これで、PL/SQL SDKのDBMS_CLOUD_OCI_OBS_OBJECT_STORAGEパッケージの型と関数を使用することができます。以下のスクリプトでは、オブジェクトストアに "examplebucketfordata"という名前の新しいバケットをトロントリージョンに作成します。


クラウドにデータを保存することに馴染みがない方のために。バケットとは、大小のデータファイルを保存できるコンテナのことです（コンピュータのフォルダにファイルを保存するのと似ています）。クラウドのObject Storageとバケットについて詳しくは、こちらをご覧ください。


必要なリソースの詳細がどこにあるかについては、以下の画面を参照してください。


set serveroutput on
declare
  l_type_status  PLS_INTEGER;
  resp_body      dbms_cloud_oci_obs_object_storage_bucket_t;
  response       dbms_cloud_oci_obs_object_storage_create_bucket_response_t;
  bucket_details dbms_cloud_oci_obs_object_storage_create_bucket_details_t;
  l_json_obj     json_object_t;
  l_keys         json_key_list;
begin
  bucket_details := dbms_cloud_oci_obs_object_storage_create_bucket_details_t();
  bucket_details.name := 'examplebucketfordata'; 
  bucket_details.compartment_id := 'ocid1.compartment.oc1...';
  --Note the use of the native SDK function create_bucket
  response := dbms_cloud_oci_obs_object_storage.create_bucket(
                namespace_name => 'adwc4pm',
                opc_client_request_id => 'xxxxxxxxx',
                create_bucket_details => bucket_details,
                credential_name => 'SDK_CRED',
                region => 'ca-toronto-1');
 
  resp_body := response.response_body;
 
  -- Response Headers
  dbms_output.put_line('Headers: ' || CHR(10) ||'------------');
  l_json_obj := response.headers;
  l_keys := l_json_obj.get_keys;
  for i IN 1..l_keys.count loop
     dbms_output.put_line(l_keys(i)||':'||l_json_obj.get(l_keys(i)).to_string);
  end loop;
    
  -- Response status code
  dbms_output.put_line('Status Code: ' || CHR(10) || '------------' || CHR(10) ||      response.status_code);
  dbms_output.put_line(CHR(10));
 
end;
/


  •     左ペインのメニューをスライドさせ、「アイデンティティ」→「コンパートメント」→「自分のコンパートメント」で、自分のコンパートメントOCIDを見つけることができます。



  •     ネームスペースは、左のペンメニューの「管理」→「テナントの詳細」で確認できます。



  •     あなたのリージョンの識別子は、ここで調べることができます。



以下は出力を簡略化したものですが、REST API 呼び出しで期待されるように、完全なレスポンスヘッダとボディを受け取っていることに注目してください。この情報を使って、ステータスコード、リソースの場所、その他アプリケーションのロジックに必要な情報を調べることができます。



このスクリプトを実行し、成功のレスポンスコード（200）を取得すると、オブジェクトストアに新しく作成されたバケットができあがります！このバケットを使用して、データをアップロードしたり、ファイルを管理したりすることができます。あとは DBMS_CLOUD パッケージを使って同様のスクリプトを書き、データのアップロードやBucket内のファイル管理などを行うことができます。




まとめ：Oracle Function のフレンドリーな例の再確認


最後に、前回のOracle Functionの例を書き直してみましょう。この例では、REST API 呼び出しに汎用 DBMS_CLOUD.SEND_REQUEST を使用し、「Hello <名前>」と表示するシンプルな Oracle Function を呼び出しています。DBMS_CLOUD_OCI_FNC_FUNCTIONS_INVOKE パッケージを使用して、Oracle Function "fndemo" OCID を提供します。これは Function のコンソールページにある、呼び出しエンドポイントと共に表示されます。


この汎用関数は、他のクラウドプラットフォームの REST API を呼び出すのに有効ですが、新しい SDK では、パラメータとレスポンスにネイティブ PL/SQL オブジェクトを使用しているため、コードの品質が向上し、エラーのマージンが少なくなっていることに注目してください。これは、Autonomousの世界では、物事がよりシンプルになるように常に進化していることを示す素晴らしい例です。

declare
  resp_body      blob;
  response       dbms_cloud_oci_fnc_functions_invoke_invoke_function_response_t;   
  l_json_obj     json_object_t;
  l_keys         json_key_list;
begin
    -- Note the use of the native SDK function invoke_function
  response := dbms_cloud_oci_fnc_functions_invoke.invoke_function(
                function_id => 'ocid1.tenancy.oc2...',
                invoke_function_body => UTL_RAW.cast_to_raw('Nilay'),
                credential_name => 'SDK_CRED',
                region => 'ca-toronto-1');
 
  resp_body := response.response_body;
 
  -- Response status code
  dbms_output.put_line('Status Code: ' || CHR(10) || '------------' || CHR(10) ||       response.status_code);
  dbms_output.put_line(CHR(10));
 
end;
/



コメント

コメントを投稿

このブログの人気の投稿

Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20)

イメージ
Oracle Database 19cサポート・タイムラインの重要な更新 (2024/11/20) https://mikedietrichde.com/2024/11/20/important-update-to-oracle-database-19c-support-timelines/ 長い沈黙は、私が隠れているという意味ではありません。つまり、今はとても忙しいということです。そして、より少ない旅行で、私はあなたのコメントにもブログと返信するより多くの時間を持っていることを願っています。それでも、Oracle Database 19cサポート・タイムラインの非常に重要な更新について説明します。 * 更新された内容 2024年11月19日現在、Oracle Database 19cのサポート・タイムラインが調整されています。 MOSノート: 742060.1 – 現在のデータベース・リリースのリリース・スケジュールを見ると、新しい日付が表示されます。 Premier Support、2029年12月31日まで 2030年1月1日から2032年12月31日までの拡張サポート 2033年1月1日から2034年12月31日までのアップグレード・サポート これは知ることがとても大切です。 他のリリースの更新はありますか。 MOSノートの終わりにある変更ログ: 742060.1 – 現在のデータベース・リリースのリリース・スケジュールでは、Oracle Database 21cの最新の更新も確認できます。このリリースのPremier Support期間は、2027年7月31日まで延長されました。 また、Oracle Database 23aiのパッチ適用終了日は2032年12月31日に設定されています。 Lifetime Support Policy 更新は、Oracle Technology Productsの Oracle Lifetime Support Policy (6ページ)でも確認できます。 From: Oracle Lifetime Support Policy for Oracle Technology Product s – page 6 – Nov 19, 2024 特に、次の表に示す制限事項に注意してください。 Oracle Database 1...
続きを読む

Oracle APEXのInteractive Gridで、Oracle Formsと比較して、重複行の検証を制御/通過させる方法 (2022/07/21)

イメージ
Oracle APEXのInteractive Gridで、Oracle Formsと比較して、重複行の検証を制御/通過させる方法 (2022/07/21) https://medium.com/oracledevs/how-to-control-or-pass-validation-for-duplicate-rows-in-interactive-grid-of-oracle-apex-as-compare-18f453f750bf 投稿者： Jignesh oracle Formsでは、データブロックの重複行を制御するのは非常に簡単ですが、IGの検証を制御するにはどうすればよいでしょうか。 必要な出力 ステップ1：インタラクティブグリッドのある白紙ページを作成します（私は1つの領域「IG」を作成し、インタラクティブグリッドとしてタイプを選択しました） ステップ 2: リージョンに Static ID を定義する (私の場合、リージョンは IG で、Static ID も IG です) ステップ3：複製を制御したいカラムのStatic IDを定義します ステップ4：関数とグローバル変数に移動します コード： var validity, message, ui = this.data; (function($) { function update(model) { var projKey = model.getFieldKey(“PROJECT_ID”), recObj = [], recArray = []; model.forEach(function(record, index, id) { var projid = parseInt(record[projKey], 10), // record[salKey] should be a little faster than using model.getValue in a loop meta = model.getRecordMetadata(id); if (!isNaN(projid) && !meta.deleted && !meta.agg) { recObj = {ID: id, project_id: projid}; recArray.push(recObj)...
続きを読む

Oracle APEX 24.1の一般提供の発表 (2024/06/17)

イメージ
Oracle APEX 24.1の一般提供の発表 (2024/06/17) https://blogs.oracle.com/apex/post/announcing-oracle-apex-241 投稿者： Ashish Mohindroo | Vice President, Product Management APEX Low Code Application Platform Oracle APEX 24.1は、 ダウンロード が一般的に可能になり、世界中のOCI APEX Application DevelopmentおよびAutonomous Database Cloud Serviceリージョンにロールアウトされています。この最新リリースで、GenAIを使用して最初のローコード・アプリケーションを構築する方法を学習します。リリースのお知らせのリプレイはこちらからご覧いただけます。 このリリースでは、優れたエンタープライズ・グレードのアプリケーションを簡単に構築できるイノベーションの3つの主要な柱(AI支援アプリケーション開発、Oracleの次世代データ・プラットフォームのパワー活用、高度なWebおよびモバイル・アプリケーションを構築するための強力なエンタープライズ・グレードのコンポーネント)が提供されています。 AI支援アプリ開発 このリリースでは、AIをローコード開発に直接取り込み、すべての開発者が高度なクラウドおよびモバイル・アプリケーションを簡単に構築できるようにしています。開発者は、AIをアシスタントとして使用して、時間と労力を削減してアプリを構築できるようになりました。APEX AIアシスタントを使用すると、開発者は複数のウィンドウを使用して表名と列名を検索する必要がなくなります。 APEX 24.1 では、クラウドおよびモバイル・アプリの自然言語ベースの開発を可能にするネイティブAI搭載APEX AIアシスタントを導入しました。APEX AIアシスタントを使用すると、すべての開発者は自然言語を使用してSQLを生成できるため、アプリケーションをより簡単に構築したり、ワンクリックで構文修正を実行したり、表名を覚える必要がなくなります。開発者は、自然言語プロンプトを使用して目的の機能とコンポーネントを指定し、直感的な会話型インタフェースを使用し...
続きを読む