Oracle Database

  • リファレンス

Oracle Database は、Oracle が開発したリレーショナル データベース管理システムです。 オンプレミスの Oracle Database に接続して、テーブルの行の作成、更新、取得、削除などのさまざまな操作を実行します。

このコネクタは、次の製品および地域で利用可能です。

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   米国国防総省 (DoD)
Power Automate プレミアム すべての Power Automate 地域
Power Apps プレミアム すべての Power Apps 地域
Contact
件名 マイクロソフト
URL Microsoft LogicApps サポート
Microsoft Power Automate サポート
Microsoft Power Apps サポート
コネクタ メタデータ
公開元 Microsoft
Web サイト https://www.oracle.com/database/
プライバシー ポリシー https://www.oracle.com/legal/privacy/

Power Apps でこのコネクタを使用するには、ここ で詳細を確認してください。

新機能

以下は Oracle コネクタの新しい更新と機能である

2018 年 1 月

  • 読み取り専用テーブルとして Oracle ビューをサポート

2018 年 10 月

  • Oracle ストアド プロシージャのサポート

前提条件

  • サポートされている Oracle のバージョン:
    • Oracle 9 以降
    • Oracle Data Access Client (ODAC) 11.2 以降
  • オンプレミスのデータ ゲートウェイをインストールする。 手順については、ロジック アプリからオンプレミスのデータに接続する を参照してください。 ゲートウェイは、オンプレミスの Oracle Database、または Oracle DB がインストールされている Azure VM に接続するために必要です。

注意

オンプレミスのデータ ゲートウェイはブリッジとして機能し、オンプレミスのデータ (クラウドにないデータ) とロジック アプリの間に、セキュリティで保護されたデータ転送を提供します。 そのゲートウェイは、複数のサービス、および複数のデータ ソースで使用できます。 したがって、ゲートウェイをインストールするのは 1 回だけで済みます。

  • オンプレミスのデータ ゲートウェイをインストールしたコンピューターで Oracle クライアントをインストールする。 xcopy バージョンはオンプレミス データ ゲートウェイで動作しないため、Oracle から 64 ビット Oracle Data Provider for .NET をインストールし、Windows インストーラーのバージョンを選択します: 64 ビット ODAC 12c Release 4 (12.1.0.2.4) for Windows x64。 次の PowerShell コマンドを実行して、インストールを確認できます: [System.Data.Common.DbProviderFactories]::GetFactoryClasses()。 Oracle Client がインストールされている場合、結果に "OracleClient データ プロバイダー" が表示されます。

ヒント

Oracle クライアントがインストールされていない場合、接続の作成または使用を試みると、エラーが発生します。 コネクタの詳細セクション の一般的なエラーを参照してください。

  • Oracle クライアントで、コネクタ操作を実行する前に、環境変数 ORA_NCHAR_LITERAL_REPLACE を TRUE に設定します。 この設定により、NCHAR 文字列リテラルの置換が有効になり、NCHAR/NVARCHAR/NCLOB 型の列にデータベース文字セットを超える文字を含む文字列リテラルを挿入する場合のデータの損失を防ぐことができます。 文字列リテラルは内部形式に変換され、ステートメントの実行時に Unicode に適切にデコードされます。

既知の問題と制限事項

以下は、Oracle コネクタを使用する際の既知の制限の一部です。

  1. Oracle サーバーでストアド プロシージャを呼び出す場合、次の制限があります。
    • OUT パラメーターは現在サポートされていません。
    • Oracle ストアド プロシージャは結果を返さないため、戻り値は使用できません。
  2. Oracle Functions はサポートされていないため、UI に表示されません。
  3. 応答サイズの制限は 8MB です。
  4. 要求サイズの制限は 2MB です。
  5. Oracle ネイティブ クエリは、次の制限付きでサポートされています。
    • RefCursor はサポートされていません。
    • OUT パラメーターはサポートされていません。
    • 1 つの結果セットのみを返すことができます。
    • ゲートウェイ バージョン 3000.63.4 (10月リリース) 以降が必要です。
  6. 次のデータ型は、クエリ オプションの述語として使用できません。
    • DATE
    • TIMESTAMP
    • タイムゾーン付きの TIMESTAMP
    • ローカル タイムゾーン付きの TIMESTAMP
  7. Oracle クエリまたはストアド プロシージャの実行時間が 110 秒を超えると、アクションはタイムアウトします。
  8. テーブルへの挿入と更新では、項目全体は返されず、操作の入力プロパティのみが返されます。
  9. GetRows 操作の確定的なページング結果を取得するには、主キーが必要です。
  10. 行を挿入操作では、デフォルト/自動インクリメント値が定義されている場合でも、主キー列に明示的な値を指定する必要があります。
  11. UI コンポーネントの制限により、設計時にレンダリングされるテーブルのリストは、テーブルの取得 操作の既定のページ サイズである 2048 を超える要素を表示できません。 例:
    • 「テーブル名」行の取得 アクション パラメーターのテーブルの一覧。
    • PowerApps デザイナーの「接続の作成/テーブルの選択」フローのテーブルの一覧。
  12. Oracle データベースの操作中に遅延が発生する場合は、最新の 64 ビット Oracle Data Access Components (ODAC) をインストールすることをお勧めします。 これは、ゲートウェイ マシン (または、ゲートウェイがクラスターの場合は各ゲートウェイ マシン) にインストールする必要があります。
  13. Oracle 接続の作成がタイムアウトで失敗した場合は、最小限のアクセス許可を持つ Oracle 資格情報を使用してみてください。これにより、接続がより軽くなり、接続作成中にタイムアウトが発生するのを回避できることがあります。

コネクタの詳細

コネクタの詳細については、詳細セクション を参照してください。

一般的な制限

名称 価値
接続ごとにコネクタによって同時に処理される要求の最大数 200
接続ごとにコネクタを通じて同時に転送される最大メガバイト数 30

接続の作成

コネクタは、次の認証タイプをサポートしています:
既定 接続を作成するためのパラメーター。 すべてのリージョン 共有可能

既定

適用できるもの: すべての領域

接続を作成するためのパラメーター。

これは共有可能な接続です。 Power App が他のユーザーと共有されている場合、接続も共有されます。 詳細については、キャンバス アプリのコネクタの概要 - Power Apps | Microsoft Docs を参照してください

件名 タイプ 内容 必要
サーバー 文字列 Oracle サーバーを指定します。 ポートまたは SID が必要な場合は、ServerName:Port/SID の形式で指定します。 真
認証の種類 [基本を選択] 文字列 データベースに接続するための認証の種類
ユーザー名 securestring ユーザー名資格情報 真
パスワード securestring パスワード資格情報 真
ゲートウェイ gatewaySetting オンプレミス ゲートウェイ (詳細については、https://docs.microsoft.com/data-integration/gateway を参照してください 真

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 1500 60 秒

アクション

Oracle クエリを実行する

Oracle クエリを実行する
ストアド プロシージャの実行

この操作はストアド プロシージャを実行します。
テーブルを取得する

この操作はデータベースからテーブルを取得します。
行の削除

この操作はテーブルから行を削除します。
行の挿入

この操作はテーブルに新しい行を挿入します。
行を取得する

この操作はテーブルから行を取得します。
行を更新します

この操作はテーブルにある既存の行を更新します。
複数行を取得

この操作はテーブルから複数の行を取得します。

Oracle クエリを実行する

操作 ID:
ExecutePassThroughNativeQuery

Oracle クエリを実行する

パラメーター

名前 キー 必須 型 説明
Query
 query True dynamic

クエリの本文

戻り値

この操作の出力は状況に応じて変わります。

ストアド プロシージャの実行

操作 ID:
ExecuteProcedure

この操作はストアド プロシージャを実行します。

パラメーター

名前 キー 必須 型 説明
プロシージャ名
 procedure True string

ストアド プロシージャの名前
パラメーター一覧
 parameters True dynamic

ストアド プロシージャへの入力パラメーター

戻り値

この操作の出力は状況に応じて変わります。

テーブルを取得する

操作 ID:
GetTables

この操作はデータベースからテーブルを取得します。

戻り値

テーブルの一覧を表します。

本文​​
TablesList

行の削除

操作 ID:
DeleteItem

この操作はテーブルから行を削除します。

パラメーター

名前 キー 必須 型 説明
テーブル名
 table True string

テーブルの名前
行 ID
 id True string

削除する行を表す一意の識別子

行の挿入

操作 ID:
PostItem

この操作はテーブルに新しい行を挿入します。

パラメーター

名前 キー 必須 型 説明
テーブル名
 table True string

テーブルの名前
行
 item True dynamic

指定したテーブルに挿入する行

戻り値

この操作の出力は状況に応じて変わります。

行を取得する

操作 ID:
GetItem

この操作はテーブルから行を取得します。

パラメーター

名前 キー 必須 型 説明
テーブル名
 table True string

Oracle テーブルの名前
行 ID
 id True string

取得する行を表す一意の識別子

戻り値

この操作の出力は状況に応じて変わります。

行を更新します

操作 ID:
PatchItem

この操作はテーブルにある既存の行を更新します。

パラメーター

名前 キー 必須 型 説明
テーブル名
 table True string

テーブルの名前
行 ID
 id True string

更新する行を表す一意の識別子
行
 item True dynamic

更新された値を含む行です

戻り値

この操作の出力は状況に応じて変わります。

複数行を取得

操作 ID:
GetItems

この操作はテーブルから複数の行を取得します。

パラメーター

名前 キー 必須 型 説明
テーブル名
 table True string

Oracle テーブルの名前
フィルター クエリ
 $filter string

返されるエントリを制限する ODATA フィルター クエリです (例: stringColumn eq 'string' OR numberColumn lt 123)。
並べ替え順
 $orderby string

エントリの順序を指定するための ODATA orderBy クエリです。
上から順に取得
 $top integer

取得するエントリの合計数です (既定値 = すべて)。
スキップ数
 $skip integer

スキップするエントリ数です (既定値 = 0)。
クエリを選択する
 $select string

エントリから取得する特定のフィールドです (既定値 = すべて)。

戻り値

この操作の出力は状況に応じて変わります。

定義

テーブル

テーブルを表します。

名前 パス 型 説明
件名
 Name string

テーブルの名前です。 名前は実行時に使用されます。
表示名
 DisplayName string

テーブルの表示名です。
DynamicProperties
 DynamicProperties object

コネクタによってクライアントに提供された追加のテーブル プロパティです。

TablesList

テーブルの一覧を表します。

名前 パス 型 説明
値
 value array of Table

テーブルの一覧