Oracle Database
Oracle Database est un système de gestion de base de données relationnelle développé par Oracle. Connectez-vous à Oracle Database local pour effectuer différentes actions telles que la création, la mise à jour, l’obtention et la suppression sur les lignes d’une table.
Ce connecteur est disponible dans les produits et régions suivants :
| Service | classe | Régions |
|---|---|---|
| Copilot Studio | Premium | Toutes les régions Power Automate |
| Applications logiques | Norme | Toutes les régions Logic Apps , à l’exception des suivantes : - Us Department of Defense (DoD) |
| Power Apps | Premium | Toutes les régions Power Apps |
| Power Automate | Premium | Toutes les régions Power Automate |
| Contact | |
|---|---|
| Nom | Microsoft |
| URL |
Microsoft LogicApps Support Prise en charge de Microsoft Power Automate Prise en charge de Microsoft Power Apps |
| Métadonnées du connecteur | |
|---|---|
| Éditeur | Microsoft |
| Site internet | https://www.oracle.com/database/ |
| Politique de confidentialité | https://www.oracle.com/legal/privacy/ |
Cet article décrit les opérations du connecteur Oracle Database, qui est disponible pour Azure Logic Apps, Microsoft Power Apps et Microsoft Power Automate. Vous pouvez utiliser ce connecteur pour vous connecter à une base de données Oracle locale ou à une machine virtuelle Azure avec Oracle Database installé.
- Pour utiliser ce connecteur dans Power Apps, consultez Se connecter à une base de données Oracle à partir de Power Apps.
Quoi de neuf
Le tableau suivant décrit les nouvelles mises à jour et fonctionnalités pour Oracle Databaseconnector :
| Update | Descriptif |
|---|---|
| Octobre 2018 | Prend en charge la procédure stockée Oracle. |
| Janvier 2018 | Prend en charge l’affichage Oracle en tant que table en lecture seule. |
Prerequisites
Versions d’Oracle prises en charge :
- Oracle 9 et versions ultérieures
- Client Oracle Data Access (ODAC) 11.2 et versions ultérieures
Pour vous connecter à une base de données Oracle locale ou à une machine virtuelle Azure avec Oracle Database installée, vous devez installer la passerelle de données locale.
Cette passerelle agit comme un pont et fournit un transfert de données sécurisé entre les données locales et votre application ou client. Vous pouvez utiliser la même installation de passerelle avec plusieurs services et sources de données, ce qui signifie que vous devrez peut-être installer la passerelle une seule fois.
Pour Microsoft Power Apps, consultez également Gérer une passerelle de données locale dans Power Apps.
Pour Azure Logic Apps, vous devez également créer une ressource de passerelle Azure pour l’installation de votre passerelle avant de pouvoir utiliser le connecteur. Pour plus d’informations, consultez Se connecter aux données locales à partir d’applications logiques.
Installez votre client Oracle sur l’ordinateur sur lequel vous avez installé la passerelle de données locale. Veillez à installer le fournisseur de données Oracle 64 bits pour .NET à partir d’Oracle, puis sélectionnez la version de Windows Installer, car la
xcopyversion ne fonctionne pas avec la passerelle de données locale : 64 bits ODAC 12c Version 4 (12.1.0.2.4) pour Windows x64. Vous pouvez vérifier l’installation en exécutant la commande PowerShell suivante :[System.Data.Common.DbProviderFactories]::GetFactoryClasses(). Si un client Oracle est installé, vous devez voir « Fournisseur de données OracleClient » dans les résultats.Note
Si le client Oracle n’est pas installé, une erreur se produit lorsque vous essayez de créer ou d’utiliser la connexion. Pour plus d’informations, consultez la section Erreurs de connexion courantes.
Avant d’exécuter des opérations de connecteur, sur votre client Oracle, définissez la variable d’environnement nommée ORA_NCHAR_LITERAL_REPLACEsur TRUE.
Ce paramètre active le remplacement littéral de chaîne NCHAR, ce qui empêche la perte de données lorsque les littéraux de chaîne qui contiennent des caractères au-delà du jeu de caractères de base de données sont insérés dans la colonne de type NCHAR/NVARCHAR/NCLOB . Lorsque l’instruction s’exécute, les littéraux de chaîne sont convertis en format interne, puis correctement décodés en Unicode.
Problèmes connus et limitations
La liste suivante décrit certaines limitations connues pour le connecteur Oracle Datbase :
Non pris en charge :
- N’importe quelle table avec des clés composites
- Types d’objets imbriqués dans des tables
- Fonctions de base de données avec des valeurs non scalaires
- Les fonctions Oracle ne sont donc pas répertoriées dans l’interface utilisateur.
Lorsque vous appelez une procédure stockée sur un serveur Oracle, les limitations suivantes s’appliquent :
- Les paramètres OUT ne sont pas pris en charge.
- La valeur de retour n’est pas disponible, car la procédure stockée ne retourne aucun résultat.
La limite de taille de réponse est de 8 Mo.
La limite de taille de la requête est de 2 Mo.
La requête native Oracle est prise en charge avec les limitations suivantes :
- Nécessite la passerelle version 3000.63.4 (version d’octobre) ou ultérieure.
- RefCursor n’est pas pris en charge.
- Les paramètres OUT ne sont pas pris en charge.
- Un seul jeu de résultats peut être retourné.
Les types de données suivants ne peuvent pas être utilisés comme prédicats d’option de requête :
- DATE
- TIMESTAMP
- TIMESTAMP avec fuseau horaire
- TIMESTAMP avec fuseau horaire local
Si une requête Oracle ou un délai d’exécution de procédure stockée dépasse 110 secondes, l’action expire.
L’insertion et la mise à jour d’une table ne retournent pas l’élément complet. Ils retournent uniquement les propriétés d’entrée de l’opération.
Pour obtenir des résultats de pagination déterministes pour l’opération Obtenir des lignes , une clé primaire est requise.
L’opération Insérer une ligne nécessite que vous fournissez une valeur explicite pour la colonne Clé primaire, même si la valeur par défaut/autoincrement est définie.
En raison des limitations des composants de l’interface utilisateur, la liste des tables affichées pendant le temps de conception ne peut pas afficher plus de 2 048 éléments, qui est la taille de page par défaut pour l’opération Obtenir les tables , par exemple :
- Liste des tables pour le paramètre d’action Get rows nommé « Nom de table ».
- Liste des tables pour le flux « Créer une connexion/Choisir une table » dans le concepteur Power Apps.
Si vous observez la latence lors de l’utilisation de la base de données Oracle, installez les derniers composants Oracle Data Access Components (ODAC) 64 bits sur la machine de passerelle ou chaque ordinateur de passerelle, si la passerelle est un cluster.
Si la création de la connexion Oracle échoue avec un délai d’expiration, essayez d’utiliser des informations d’identification Oracle avec une autorisation minimale. De cette façon, la connexion est plus légère, ce qui peut vous aider à éviter de rencontrer le délai d’expiration pendant la création de la connexion.
Erreurs de connexion courantes
Erreur : Impossible d’atteindre la passerelle
Cause : la passerelle de données locale ne peut pas se connecter au cloud.
Atténuation : assurez-vous que votre passerelle s’exécute sur l’ordinateur local où vous avez installé la passerelle et dispose d’une connectivité Internet. Évitez d’installer la passerelle sur un ordinateur susceptible d’être désactivé ou d’être en veille. Vous pouvez également essayer de redémarrer le service de passerelle de données local (PBIEgwService).
Erreur : le fournisseur utilisé est déconseillé : « System.Data.OracleClient requiert le logiciel client Oracle version 8.1.7 ou ultérieure. » Voir https://go.microsoft.com/fwlink/p/?LinkID=272376 pour installer le fournisseur officiel.
Cause : le Kit de développement logiciel (SDK) client Oracle n’est pas installé sur l’ordinateur sur lequel la passerelle de données locale est en cours d’exécution.
Résolution : téléchargez et installez le Kit de développement logiciel (SDK) client Oracle sur le même ordinateur que la passerelle de données locale.
Erreur : la table '[Tablename]' ne définit aucune colonne clé
Cause : la table n’a pas de clé primaire.
Résolution : Le connecteur Oracle Database nécessite d’utiliser une table avec une colonne de clé primaire.
Limites générales
| Nom | Valeur |
|---|---|
| Nombre maximal de requêtes traitées par le connecteur simultanément par connexion | 200 |
| Nombre maximal de mégaoctets transférés via le connecteur simultanément par connexion | 30 |
Création d’une connexion
Le connecteur prend en charge les types d’authentification suivants :
| Par défaut | Paramètres de création de connexion. | Toutes les régions | Partageable |
Faire défaut
Applicable : Toutes les régions
Paramètres de création de connexion.
Il s’agit d’une connexion partageable. Si l’application d’alimentation est partagée avec un autre utilisateur, la connexion est également partagée. Pour plus d’informations, consultez la vue d’ensemble des connecteurs pour les applications de canevas - Power Apps | Microsoft Docs
| Nom | Type | Descriptif | Obligatoire |
|---|---|---|---|
| Serveur | ficelle | Spécifiez le serveur Oracle. Si un port ou un SID est requis, spécifiez sous la forme ServerName :Port/SID. | Vrai |
| Type d’authentification [Sélectionner de base] | ficelle | Type d’authentification pour vous connecter à votre base de données | |
| Nom d’utilisateur | securestring | Informations d’identification du nom d' | Vrai |
| Mot de passe | securestring | Informations d’identification du mot de passe | Vrai |
| Gateway | gatewaySetting | Passerelle locale (voir https://docs.microsoft.com/data-integration/gateway pour plus d’informations | Vrai |
Limitations
| Nom | Appels | Période de renouvellement |
|---|---|---|
| Appels d’API par connexion | 1500 | 60 secondes |
Actions
| Exécuter une procédure stockée |
Cette opération exécute une procédure stockée. |
| Exécuter une requête Oracle |
Exécuter une requête Oracle |
| Insérer une ligne |
Cette opération insère une nouvelle ligne dans une table. |
| Mettre à jour la ligne |
Cette opération met à jour une ligne existante dans une table. |
| Obtenir des lignes |
Cette opération obtient des lignes d’une table. |
| Obtenir des tables |
Cette opération obtient des tables d’une base de données. |
| Obtenir une ligne |
Cette opération obtient une ligne d’une table. |
| Supprimer une ligne |
Cette opération supprime une ligne d’une table. |
Exécuter une procédure stockée
Cette opération exécute une procédure stockée.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la procédure
|
procedure | True | string |
Nom de la procédure stockée |
|
Liste des paramètres
|
parameters | True | dynamic |
Paramètres d’entrée de la procédure stockée |
Retours
Exécuter une requête Oracle
Exécuter une requête Oracle
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Query
|
query | True | dynamic |
corps de requête |
Retours
Insérer une ligne
Cette opération insère une nouvelle ligne dans une table.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la table
|
table | True | string |
Nom de la table |
|
Ligne
|
item | True | dynamic |
Ligne à insérer dans la table spécifiée |
Retours
Mettre à jour la ligne
Cette opération met à jour une ligne existante dans une table.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la table
|
table | True | string |
Nom de la table |
|
ID de ligne
|
id | True | string |
Identificateur unique de la ligne à mettre à jour |
|
Ligne
|
item | True | dynamic |
Ligne avec des valeurs mises à jour |
Retours
Obtenir des lignes
Cette opération obtient des lignes d’une table.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la table
|
table | True | string |
Nom de la table Oracle |
|
Filtrer la requête
|
$filter | string |
Requête de filtre ODATA pour restreindre les entrées retournées (par exemple, stringColumn eq 'string' OR numberColumn lt 123). |
|
|
Commande par
|
$orderby | string |
Requête ODATA orderBy pour spécifier l’ordre des entrées. |
|
|
Nombre supérieur
|
$top | integer |
Nombre total d’entrées à récupérer (valeur par défaut = all). |
|
|
Ignorer le nombre
|
$skip | integer |
Nombre d’entrées à ignorer (valeur par défaut = 0). |
|
|
Sélectionner la requête
|
$select | string |
Champs spécifiques à récupérer à partir d’entrées (valeur par défaut = all). |
Retours
Obtenir des tables
Cette opération obtient des tables d’une base de données.
Retours
Représente une liste de tables.
- Corps
- TablesList
Obtenir une ligne
Cette opération obtient une ligne d’une table.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la table
|
table | True | string |
Nom de la table Oracle |
|
ID de ligne
|
id | True | string |
Identificateur unique de la ligne à récupérer |
Retours
Supprimer une ligne
Cette opération supprime une ligne d’une table.
Paramètres
| Nom | Clé | Obligatoire | Type | Description |
|---|---|---|---|---|
|
Nom de la table
|
table | True | string |
Nom de la table |
|
ID de ligne
|
id | True | string |
Identificateur unique de la ligne à supprimer |
Définitions
Table
Représente une table.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
Nom
|
Name | string |
Nom de la table. Le nom est utilisé au moment de l’exécution. |
|
DisplayName
|
DisplayName | string |
Nom complet de la table. |
|
DynamicProperties
|
DynamicProperties | object |
Propriétés de table supplémentaires fournies par le connecteur aux clients. |
TablesList
Représente une liste de tables.
| Nom | Chemin d’accès | Type | Description |
|---|---|---|---|
|
value
|
value | array of Table |
Liste des tables |