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 コネクタの新しい更新と機能である
- 読み取り専用テーブルとして Oracle ビューをサポート
- 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 コネクタを使用する際の既知の制限の一部です。
- Oracle サーバーでストアド プロシージャを呼び出す場合、次の制限があります。
- OUT パラメーターは現在サポートされていません。
- Oracle ストアド プロシージャは結果を返さないため、戻り値は使用できません。
- Oracle Functions はサポートされていないため、UI に表示されません。
- 応答サイズの制限は 8MB です。
- 要求サイズの制限は 2MB です。
- Oracle ネイティブ クエリは、次の制限付きでサポートされています。
- RefCursor はサポートされていません。
- OUT パラメーターはサポートされていません。
- 1 つの結果セットのみを返すことができます。
- ゲートウェイ バージョン 3000.63.4 (10月リリース) 以降が必要です。
- 次のデータ型は、クエリ オプションの述語として使用できません。
- DATE
- TIMESTAMP
- タイムゾーン付きの TIMESTAMP
- ローカル タイムゾーン付きの TIMESTAMP
- Oracle クエリまたはストアド プロシージャの実行時間が 110 秒を超えると、アクションはタイムアウトします。
- テーブルへの挿入と更新では、項目全体は返されず、操作の入力プロパティのみが返されます。
- GetRows 操作の確定的なページング結果を取得するには、主キーが必要です。
- 行を挿入操作では、デフォルト/自動インクリメント値が定義されている場合でも、主キー列に明示的な値を指定する必要があります。
- UI コンポーネントの制限により、設計時にレンダリングされるテーブルのリストは、テーブルの取得 操作の既定のページ サイズである 2048 を超える要素を表示できません。 例:
- 「テーブル名」行の取得 アクション パラメーターのテーブルの一覧。
- PowerApps デザイナーの「接続の作成/テーブルの選択」フローのテーブルの一覧。
- Oracle データベースの操作中に遅延が発生する場合は、最新の 64 ビット Oracle Data Access Components (ODAC) をインストールすることをお勧めします。 これは、ゲートウェイ マシン (または、ゲートウェイがクラスターの場合は各ゲートウェイ マシン) にインストールする必要があります。
- 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 クエリを実行する
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
Query
|
query | True | dynamic |
クエリの本文 |
戻り値
この操作はストアド プロシージャを実行します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
プロシージャ名
|
procedure | True | string |
ストアド プロシージャの名前 |
パラメーター一覧
|
parameters | True | dynamic |
ストアド プロシージャへの入力パラメーター |
戻り値
この操作はテーブルから行を削除します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
テーブル名
|
table | True | string |
テーブルの名前 |
行 ID
|
id | True | string |
削除する行を表す一意の識別子 |
この操作はテーブルに新しい行を挿入します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
テーブル名
|
table | True | string |
テーブルの名前 |
行
|
item | True | dynamic |
指定したテーブルに挿入する行 |
戻り値
この操作はテーブルから行を取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
テーブル名
|
table | True | string |
Oracle テーブルの名前 |
行 ID
|
id | True | string |
取得する行を表す一意の識別子 |
戻り値
この操作はテーブルにある既存の行を更新します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
テーブル名
|
table | True | string |
テーブルの名前 |
行 ID
|
id | True | string |
更新する行を表す一意の識別子 |
行
|
item | True | dynamic |
更新された値を含む行です |
戻り値
この操作はテーブルから複数の行を取得します。
パラメーター
名前 | キー | 必須 | 型 | 説明 |
---|---|---|---|---|
テーブル名
|
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 |
コネクタによってクライアントに提供された追加のテーブル プロパティです。 |
テーブルの一覧を表します。
名前 | パス | 型 | 説明 |
---|---|---|---|
値
|
value | array of Table |
テーブルの一覧 |