Partager via


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é.

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.

  • 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 xcopy version 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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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

Les sorties de cette opération sont dynamiques.

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