Configuration de sources distantes

Objective

After completing this lesson, you will be able to créez une source distante à l'aide de l'interface utilisateur ou du SQL.

Configuration de la source distante avec l'interface utilisateur graphique

Lorsque les conditions préalables techniques et de sécurité sont remplies, vous êtes prêt à créer une source distante. Il existe deux façons principales de le faire :

Dans le catalogue de l'explorateur de base de données SAP HANA, avec l'interface utilisateur graphique
Dans n'importe quelle console SQL connectée à votre base de données locale/cible, avec une instruction SQL

Examinons d'abord le processus de création graphique basé sur l'interface utilisateur.

Création d'une source distante avec l'interface utilisateur graphique

Accédez au catalogue et accédez à la section Sources distantes.
Cliquez avec le bouton droit de la souris sur Sources distantes et sélectionnez Ajouter une source distante.
Définissez le nom de la source distante.
Sélectionnez l' adaptateur pertinent.
Pour les sources distantes SDI, indiquez un site d'adaptateur ("Site de départ").
Renseignez la propriété de la source distante.
Sélectionnez Créer.

Lancez cette vidéo pour apprendre à créer une source distante Smart Data Access avec l'éditeur basé sur un formulaire dans l'explorateur de base de données SAP HANA.

La création de sources distantes pour les scénarios Smart Data Integration avec l'interface utilisateur graphique est très similaire à ce que nous venons de discuter. L'une des principales différences réside dans le fait que les adaptateurs ne s'exécutent pas sur le serveur d'index de l'instance de base de données SAP HANA, il est nécessaire de spécifier l'emplacement des adaptateurs. Voici un rappel :

Les adaptateurs OData s'exécutent sur le serveur de mise à disposition de données (dans la base de données).
Le dpserver de site est affecté automatiquement et ne peut pas être modifié.
Tous les autres adaptateurs Smart Data Integration s'exécutent sur un agent de mise à disposition de données.
Vous indiquez un agent de mise à disposition de données, soit un groupe d'agents de mise à disposition de données si plusieurs agents font partie d'un groupe d'agents haute disponibilité.
Remarque
La configuration des agents est déterminée par l'équipe d'administration du système. Ce dont vous avez simplement besoin, c'est d'informations sur l'agent ou le groupe d'agents à utiliser dans un scénario particulier.

Lancez cette vidéo pour apprendre à créer une source distante Smart Data Integration avec l'éditeur basé sur un formulaire dans l'explorateur de base de données SAP HANA.

Vérification d'une source distante

Lorsque vous créez une source distante dans l'explorateur de base de données SAP HANA avec un formulaire, deux contrôles automatiques successifs sont exécutés.

Cohérence de la source distante – Blocage
La définition de la source distante doit être "syntaxiquement" correcte avec tous les paramètres requis renseignés.
Le contrôle peut échouer, par exemple, si vous avez oublié le nom du serveur ou si vous n'avez pas indiqué le nom d'utilisateur et le mot de passe d'un utilisateur technique.
Dans ce cas, la source distante ne peut pas être créée. Vous devez modifier la définition de la source distante et essayer de la sauvegarder à nouveau.
Remarque
Dans la forme de définition de source distante, tous les paramètres obligatoires sont identifiés par un astérisque rouge.
Connectivité à la source distante – Non bloquante
Ce contrôle de second niveau, déclenché automatiquement dans le formulaire de l'explorateur de base de données SAP HANA, vérifie si la définition de la source distante permet à SAP HANA de se connecter au système distant et d'authentifier l'utilisateur distant.
Si ce contrôle n'est pas réussi, vous recevez uniquement un avertissement qui n'empêche PAS la création de la source distante.
Le contrôle peut échouer, par exemple, en raison d'une erreur dans le nom du serveur ou dans la configuration du connecteur SAP Cloud (le cas échéant), ou simplement parce que le serveur distant n'est pas disponible actuellement. Une autre raison peut être que la source distante est définie avec des identifiants secondaires, mais qu'il n'existe actuellement aucun identifiant pour votre utilisateur.
Dans ce cas, seul un avertissement est émis. Vous pouvez modifier la définition de la source distante immédiatement (par exemple, si vous identifiez une erreur évidente), mais vous pouvez également enregistrer la définition de source distante telle quelle et la modifier ultérieurement.

Configuration de la source distante avec SQL

Au lieu d'utiliser l'interface utilisateur graphique de l'explorateur de base de données SAP HANA pour créer des sources distantes, vous pouvez exécuter des instructions SQL. L'un des principaux avantages est que vous pouvez créer plusieurs sources distantes par lots très rapidement.

L'instruction SQL est structurée comme suit :

Code Snippet

123456
CREATE REMOTE SOURCE "<remote_source_name>"
ADAPTER "<adapter_name>"
AT LOCATION <agent_or_agent_group_name>
CONFIGURATION '<configuration_string>' 
WITH CREDENTIAL TYPE '<credential_type>'
                USING '<credential_definition_string>';

Prenons un exemple simple où nous allons définir une source distante Smart Data Access pointant vers un système source SAP HANA On-Premise.

Code Snippet

1234
CREATE REMOTE SOURCE "RS1"
ADAPTER "hanaodbc" 
CONFIGURATION 'ServerNode=hana_cloud_src1.mycompany.com:30115' 
WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=myuser;password=MyPassword';

Remarque

Notez que, comme il s'agit d'une source distante SAP HANA, accès intelligent aux données, il n'existe pas de clause AT LOCATION.

Pour les sources de données SAP HANA, accès intelligent aux données, il existe deux variantes pour définir la chaîne de configuration. Celle ci-dessus est plus compacte. La version la plus longue ci-dessous transmet la configuration au format XML. Ils obtiennent tous les deux le même résultat.

Code Snippet

1234567891011
CREATE REMOTE SOURCE "RS1"
ADAPTER "hanaodbc"
CONFIGURATION
'<?xml version="1.0" encoding="UTF-8"?>
<ConnectionProperties name="connectionproperties">
  <PropertyEntry name="adapterversion">1.0</PropertyEntry>
  <PropertyEntry name="connectionmode">Adapter Properties</PropertyEntry>
  <PropertyEntry name="server">hana_cloud_src1.mycompany.com</PropertyEntry>
  <PropertyEntry name="port">30015</PropertyEntry>
</ConnectionProperties>'
WITH CREDENTIAL TYPE 'PASSWORD' USING 'user=myuser;password=MyPassword';

Remarque

Ce formulaire plus long est facultatif pour la source SAP HANA, accès intelligent aux données. Elle est présentée ici car c'est ce que vous obtenez lorsque vous sélectionnez GENERATE CREATE STATEMENT à partir d'une source distante existante dans le catalogue Explorateur de base de données SAP HANA.

Lancez cette vidéo pour apprendre à créer une source distante avec une instruction SQL.

Comparaison du nom de l'adaptateur (SQL) avec le nom d'affichage de l'adaptateur (interface utilisateur graphique)

Lorsque vous utilisez à la fois SQL et l'explorateur de base de données SAP HANA pour créer des sources distantes, vous trouverez dans la table système "SYS"."ADAPTERS" la liste des adaptateurs en cours d'exécution sur la base de données SAP HANA. Cela vous permet de faire correspondre le nom d'un adaptateur utilisé dans une instruction SQL CREATE REMOTE SOURCE avec le nom d'affichage affiché dans l'explorateur de base de données SAP HANA lorsque vous créez ou modifiez une définition de source distante.

La table peut être interrogée comme suit :

Code Snippet

1
SELECT * FROM "SYS"."ADAPTERS";

Le résultat affiche tous les adaptateurs système (SDA), ainsi que tous les adaptateurs actuellement enregistrés sur l'un des agents de mise à disposition de données connectés à votre base de données SAP HANA locale.

Cette diapositive montre comment répertorier les adaptateurs disponibles

Vérification d'une source distante

Lorsque vous créez une source distante avec SQL, deux niveaux de contrôle sont disponibles.

Cohérence de la source distante – Blocage
Ce contrôle est effectué dans le cadre de l'instruction SQL CREATE REMOTE SOURCE.
La définition de la source distante doit être "syntaxiquement" correcte, avec tous les paramètres requis renseignés.
Le contrôle peut échouer, par exemple, si vous avez oublié le nom du serveur ou si vous n'avez pas fourni un nom d'agent valide dans la clause AT LOCATION (le cas échéant).
Dans ce cas, l'instruction SQL échoue et la source distante ne peut pas être créée. Vous devez modifier l'instruction SQL et l'exécuter à nouveau.
Connectivité à la source distante – Non bloquante
Ce contrôle est facultatif et ne fait pas partie de l'instruction CREATE REMOTE SOURCE.
Vous pouvez exécuter une instruction SQL supplémentaire pour vérifier si la définition de la source distante permet à SAP HANA de se connecter au système distant et d'authentifier l'utilisateur distant.
Code Snippet
```
1
CALL CHECK_REMOTE_SOURCE('<remote_source_name>');
```
L'exécution de cette procédure est réussie (contrôle réussi) ou, en cas d'échec, vous obtenez des détails sur la cause profonde dans la console SQL.
Il peut s'agir d'une erreur dans le nom du serveur ou dans la configuration du connecteur SAP Cloud, le cas échéant, ou simplement du fait que le serveur distant n'est pas disponible actuellement. Dans d'autres contextes, cela peut être dû au fait que la source distante est définie avec des identifiants secondaires, mais qu'aucun identifiant de ce type n'existe pour votre utilisateur.

Next lesson