Architecture SQL API

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 2 minutes de lecture

    • L’architecture SQL API montre comment le module d’extension s’intègre SQL APIServiceNow au système pour fournir un accès sécurisé aux données en lecture seule via les pilotes ODBC et JDBC standard de l’industrie.

    L’architecture SQL API fournit une vue de haut niveau de la façon dont les outils de Business Intelligence (BI) externes et les plateformes d’analyse de données se connectent à votre ServiceNow instance via des API de base de données standard. L’architecture fournit un accès sécurisé et en lecture seule à vos ServiceNow données tout en conservant tous les contrôles de sécurité et les restrictions d’accès.

    Vue d’ensemble de l’architecture

    La utilise SQL APIServiceNow des services Web pour fournir une interface de requête uniquement. Cette architecture permet des connexions directes à partir d’outils compatibles ODBC et JDBC à vos ServiceNow données sans exportation ni réplication de données.

    Le diagramme suivant illustre l’architecture de haut niveau de la façon dont le connecter les SQL API outils de BI externes aux ServiceNow tables via les pilotes ODBC et JDBC, tout en appliquant la sécurité et les contrôles d’accès.

    Figure 1. SQL API Diagramme d’architecture
    Diagramme d’architecture illustrant l’interaction de l’API SQL avec les composants système ServiceNow

    Composants architecturaux clés

    L’architecture SQL API se compose des composants clés suivants :

    Applications clientes
    Outils de BI externes et plateformes d’analyse de données telles que Power BI, DBeaaver et DBvisualizer qui se connectent à l’aide des protocoles ODBC ou JDBC.
    Pilotes ODBC/JDBC
    Pilotes de base de données standard qui permettent aux applications clientes d’établir des connexions et d’exécuter des requêtes SQL sur ServiceNow des données.
    ServiceNow Instance

    À l’intérieur de l’instance ServiceNow , trois couches gèrent la demande :

    • Couche de sécurité : dans cette couche, quatre contrôles sont appliqués dans l’ordre :
      1. Politique d’accès IP
      2. Limite du taux
      3. Authentification + vérification du rôle
      4. Chiffrement
    • Couche REST : Il existe des services dédiés distincts pour chaque pilote (service REST ODBC et service REST JDBC), tous deux limités aux requêtes SELECT uniquement et à débit limité, accessibles uniquement par le pilote en interne.
    • Niveau de la base de données : les requêtes atteignent d’abord la base de données principale (lecture seule, utilisée comme secours en l’absence de réplica), mais sont de préférence acheminées vers un réplica en lecture, qui isole la charge de travail BI de la base de données primaire et gère tous les JDBC/ODBC SELECT. Vous devez configurer un réplica en lecture pour acheminer les SQL API requêtes. Pour plus d'informations, consultez Acheminer SQL API les appels vers la réplique en lecture.

    Fonctionnement de l’architecture

    Lorsque vous connectez votre outil de BI à ServiceNow via le SQL API, le processus suivant se produit :

    1. Votre outil de BI établit une connexion de base de données standard à l’aide des API ODBC ou JDBC.
    2. La demande de connexion est authentifiée par rapport ServiceNow aux informations d’identification de l’utilisateur configurées pour SQL API l’accès.
    3. Une fois authentifié, vous pouvez écrire des requêtes SQL pour récupérer les données des tables et des champs autorisés ServiceNow .
    4. Traite SQL API vos requêtes via la couche des services de sécurité, en appliquant tous les contrôles de sécurité et les restrictions d’accès.
    5. Les résultats de la requête sont renvoyés sous forme de tableau standard, que votre outil de BI peut visualiser, analyser ou exporter.