[OCI]Oracle Functionsを使用する際のヒント (2020/01/27)

 Oracle Functionsを使用する際のヒント (2020/01/27)

https://www.ateam-oracle.com/some-hints-and-tips-when-using-oracle-functions
投稿者：Angelo Santagata | Architect

前書き


先日、VBCSとOracle Functionsを使用してOracle SaaSを拡張する方法についてのブログ記事を完成させ、そのコードを公開しました。
このコードを書いている間に、私はFunctionsについて多くのことを学び、他の多くの開発者が直面するであろう多くの状況に遭遇しました。
このブログ記事では、それらを一つのブログ記事にまとめています (定期的に更新していくかもしれません)。

REST サービスとしてファンクションを公開する方法


ファンクション自体は、まさに彼らが言うところの「ファンクション」であり、「何か」を行うコードの小さな断片です。
Oracle Functions自体は、彼らは "箱から出して" RESTのサポートを持っていないことで、RESTを認識していませんが、
簡単にOracle API Gatewayを使用して、RESTクライアントからファンクションにアクセスすることができます。

一般的な手順は以下の通りです。

  1. ファンクションのデプロイ
  2. API Gatewayを作成。ゲートウェイは、Oracle Functionsアプリケーションと同じVCNとサブネットにデプロイする必要があります。
    これがない場合は、API Gatewayが ファンクションを呼び出すためのネットワークルートを設定する必要があります。
  3. API Gateway のデプロイメントを作成
  4. デプロイメント内で、REST Verb/URIごとに1つずつパスを追加し、それをファンクションにマップ

これで完成です。

複数のバージョンのファンクションをサポートしたい場合、最も簡単なのは、異なるパスのファンクション用に複数のエントリを作成することです。

/cart/v1 -> Maps to OCID1
/cart/v2 -> Maps to OCID2
/cart/latest -> Maps to OCID2

上記の例では、/cart/v2と/cart/latestの両方が同じファンクションを指しています。

もう一つの問題は、VCN のセキュリティリストでポートを公開するのを忘れていた場合です（例：SSL のポート 443）。
Oracle FunctionsからカスタムHTTPエラーコードを公開する方法

ここでのシナリオは、Oracle FunctionsからHTTP-401 (Un-Authorized)やHTTP-404 (Not Found)などのカスタムエラーコードを返したい場合です。
ドキュメントを読むと、カスタム出力イベントを使用するのが正しい解決策だと思うかもしれません。

OutputEvent out = OutputEvent.fromBytes(
OutputEvent.fromBytes(("Not found : ").getBytes(), // Data
OutputEvent.SUCCESS, // Set the status code here?
"text/plain", // Content type
Headers.fromMap(customHeaders) // and additional custom headers on output
);


これは正しくありません。
カスタムのエラーコードを返したい場合、ファンクションはSUCCESS（ファンクションは成功しましたがファンクションエラーが発生しました）を返し、
Gatewayを使用してカスタムヘッダを返す必要があります。

public OutputEvent handleRequest(InputEvent rawInput, HTTPGatewayContext hctx)
{
// process request
// Do something which causes a not found error
LOGGER.info("NotFoundException Error ");
int SC_NOTFOUND=401;
int CT_TEXT_PLAIN="text/plain";
hctx.setStatusCode(SC_NOTFOUND);
return OutputEvent.fromBytes(("Not found : ").getBytes(),
OutputEvent.Status.Success,
CT_TEXT_PLAIN // Content type
);
}


安全な「もの」をファンクション設定に保存


私の最近のPOCでは、IDCSセキュリティファンクションがそれを取得できるように、OAuthのシークレットをどこかに保存する必要がありました。
当初、私はちょうどOracle Functionsの設定変数にそれを格納するだけでOKだろうと思っていましたが、
私の "セキュリティ意識の高い "仲間（Olaf！）に話した後、我々はそれがないことを決定しました。



この例を見ると、すべての設定変数がクリアテキストで表示されていることがわかるでしょう (これらは実際のクライアント ID や秘密ではありません)。
シークレットであるはずのものを保存している場合や、少なくとも制限されている場合には良くありません。

解決策は、代わりにOCIのOracle Key Management Servicesを使用することでした。
Oracle KMSを使用すると、キーストアを定義し、シークレットデータを「暗号化」するようKMSに依頼することができます。

詳細については、このブログ記事「Secure storage of confidential configuration data in Oracle Functions using Oracle OCI Key Management Services」を参照してください。

メモリ量のチェック


ファンクシを開発するときは、開発しているもののメモリ消費量を見る必要があります。Java はかなりメモリを消費します。
128Mb のメモリ (デフォルト) で問題なく動作しますが、一度 Jersey や Apache Http Client のようなフレームワークを使用し始めると、
サービスの動作が少し遅くなることに気づくかもしれません。これは、ガベージコレクタが動き回っていて、物事を遅くしているからかもしれません。

メモリを 1GB に増やすこともできますが、私自身は java のファンクシに 256MB を割り当てる傾向があります。

schema_version: 20180708
name: saasopportunitiesfn
version: 0.0.139
runtime: java
build_image: fnproject/fn-java-fdk-build:jdk11-1.0.104
run_image: fnproject/fn-java-fdk:jre11-1.0.104
cmd: com.example.saas.fn.cloudnativesaas.SaaSOpportunitiesFunctions::handleRequest
memory: 256
timeout: 60


今のところはここまでですが、このブログ記事はまた見つけたら随時更新していきたいと思います!

コメント

コメントを投稿

このブログの人気の投稿

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を生成できるため、アプリケーションをより簡単に構築したり、ワンクリックで構文修正を実行したり、表名を覚える必要がなくなります。開発者は、自然言語プロンプトを使用して目的の機能とコンポーネントを指定し、直感的な会話型インタフェースを使用し...
続きを読む