Remote-Sources einrichten

Objective

After completing this lesson, you will be able to legen Sie eine Remote-Source über die Benutzeroberfläche oder SQL an.

Remote-Source-Einrichtung mit der grafischen Benutzungsoberfläche

Wenn die technischen und sicherheitsbezogenen Voraussetzungen erfüllt sind, können Sie eine Remote-Source anlegen. Hierfür gibt es zwei Hauptmethoden:

Im Katalog des SAP-HANA-Datenbank-Explorers mit der grafischen Benutzungsoberfläche
In einer beliebigen SQL-Konsole, die mit Ihrer lokalen/Zieldatenbank verbunden ist, mit einer SQL-Anweisung

Betrachten wir zunächst den Prozess zum Anlegen grafischer Benutzungsoberflächen.

Anlegen einer Remote-Source mit der grafischen Benutzungsoberfläche

Navigieren Sie im Katalog zum Abschnitt Remote-Sources.
Klicken Sie mit der rechten Maustaste auf Remote Sources, und wählen Sie Add Remote Source.
Definieren Sie den Namen der Remote-Quelle.
Wählen Sie den entsprechenden Adapter.
Geben Sie für SDI-Remote-Sources einen Adapterspeicherort ("Quellspeicherort") an.
Füllen Sie die Remote-Source-Eigenschaft aus.
Wählen Sie Anlegen.

In diesem Video erfahren Sie, wie Sie eine Smart-Data-Access-Remote-Source mit dem formularbasierten Editor im SAP-HANA-Datenbank-Explorer anlegen.

Das Anlegen von Remote-Sources für Smart-Data-Integration-Szenarios mit der grafischen Benutzungsoberfläche ähnelt dem, was wir gerade besprochen haben. Ein wesentlicher Unterschied besteht darin, dass Sie angeben müssen, wo sich die Adapter befinden, da die Adapter nicht auf dem Indexserver der SAP-HANA-Datenbankinstanz ausgeführt werden. Hier ist eine Erinnerung:

OData-Adapter werden auf dem Datenbereitstellungsserver (innerhalb der Datenbank) ausgeführt.
Die Lokation dpserver wird automatisch zugeordnet und kann nicht geändert werden.
Alle anderen Smart-Data-Integration-Adapter werden auf einem Datenbereitstellungs-Agent ausgeführt.
Sie geben entweder einen Datenbereitstellungs-Agent oder eine Datenbereitstellungs-Agent-Gruppe an, wenn mehrere Agents Teil einer Hochverfügbarkeits-Agent-Gruppe sind.
Notiz
Die Konfiguration der Agenten wird vom Systemverwaltungsteam festgelegt. Sie benötigen lediglich die Informationen darüber, welcher Agent oder welche Agent-Gruppe in einem bestimmten Szenario verwendet werden soll.

In diesem Video erfahren Sie, wie Sie eine Smart-Data-Integration-Remote-Source mit dem formularbasierten Editor im SAP-HANA-Datenbank-Explorer anlegen.

Remote-Quelle prüfen

Wenn Sie eine Remote-Source im SAP-HANA-Datenbank-Explorer mit einem Formular anlegen, werden zwei aufeinanderfolgende automatische Prüfungen ausgeführt.

Remote-Quellenkonsistenz – Sperrung
Die Remote-Source-Definition muss "syntaktisch" korrekt sein, wobei alle erforderlichen Parameter ausgefüllt sind.
Die Prüfung kann z.B. fehlschlagen, wenn Sie den Servernamen vergessen oder den Benutzernamen und das Kennwort für einen technischen Benutzer nicht angegeben haben.
In diesem Fall kann die Remote-Quelle nicht angelegt werden. Sie müssen die Definition der Remote-Quelle ändern und versuchen, sie erneut zu sichern.
Notiz
Im Definitionsformular der Remote-Quelle sind alle obligatorischen Parameter mit einem roten Sternchen gekennzeichnet.
Remote-Source-Konnektivität – nicht blockierend
Diese Prüfung der zweiten Ebene, die automatisch im SAP-HANA-Datenbank-Explorer-Formular ausgelöst wird, prüft, ob die Remote-Source-Definition SAP HANA erlaubt, eine Verbindung zum Remote-System herzustellen und den Remote-Benutzer zu authentifizieren.
Wenn diese Prüfung nicht bestanden wird, erhalten Sie nur eine Warnung, die das Anlegen der Remote-Source NICHT verhindert.
Die Prüfung kann z.B. aufgrund eines Fehlers im Servernamen oder in der SAP-Cloud-Connector-Konfiguration (falls zutreffend) fehlschlagen, oder einfach, weil der Remote-Server derzeit nicht verfügbar ist. Ein weiterer Grund könnte sein, dass die Remote-Quelle mit sekundären Anmeldeinformationen definiert ist, aber derzeit keine Anmeldeinformationen für Ihren Benutzer vorhanden sind.
In diesem Fall wird nur eine Warnung ausgegeben. Sie können die Definition der Remote-Source sofort ändern (z.B. wenn Sie einen offensichtlichen Fehler feststellen), aber Sie können die Remote-Source-Definition auch unverändert sichern und später ändern.

Remote-Source-Einrichtung mit SQL

Alternativ zur Verwendung der grafischen Benutzungsoberfläche des SAP-HANA-Datenbank-Explorers zum Anlegen von Remote-Sources können Sie SQL-Anweisungen ausführen. Einer der Hauptvorteile besteht darin, dass Sie mehrere Remote-Quellen sehr schnell per Batch anlegen können.

Die SQL-Anweisung ist wie folgt aufgebaut:

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>';

In einem einfachen Beispiel definieren wir eine Smart-Data-Access-Remote-Source, die auf ein SAP-HANA-On-Premise-Quellsystem verweist.

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';

Notiz

Beachten Sie, dass es keine AT LOCATION -Klausel gibt, da es sich um eine SAP-HANA-Smart-Data-Access-Remote-Quelle handelt.

Für Datenquellen von SAP HANA Smart Data Access gibt es zwei Varianten zum Definieren der Konfigurationszeichenfolge. Der obige ist kompakter. Die längere Version darunter übergibt die Konfiguration als XML. Beide erzielen das gleiche Ergebnis.

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';

Notiz

Diese längere Form ist für die Quelle SAP HANA Smart Data Access optional. Sie wird hier dargestellt, da Sie dies erhalten, wenn Sie GENERATE CREATE STATEMENT aus einer vorhandenen Remote-Quelle im SAP-HANA-Datenbank-Explorer-Katalog wählen.

In diesem Video erfahren Sie, wie Sie eine Remote-Quelle mit einer SQL-Anweisung anlegen.

Passender Adaptername (SQL) mit Adapter-Anzeigename (grafisches User Interface)

Wenn Sie sowohl mit SQL als auch mit dem SAP-HANA-Datenbank-Explorer arbeiten, um Remote-Sources anzulegen, finden Sie in der Systemtabelle "SYS"."ADAPTERS" die Liste der Adapter, die derzeit auf der SAP-HANA-Datenbank ausgeführt werden. Dadurch können Sie den Namen eines Adapters, der in einer CREATE REMOTE SOURCE SQL-Anweisung verwendet wird, mit dem Anzeigenamen abgleichen, der im SAP-HANA-Datenbank-Explorer angezeigt wird, wenn Sie eine Remote-Source-Definition anlegen oder bearbeiten.

Die Tabelle kann wie folgt abgefragt werden:

Code Snippet

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

Das Ergebnis zeigt alle Systemadapter (SDA) sowie alle Adapter, die derzeit auf einem der Datenbereitstellungs-Agents registriert sind, die mit Ihrer lokalen SAP-HANA-Datenbank verbunden sind.

Diese Folie zeigt, wie Sie die verfügbaren Adapter auflisten.

Remote-Quelle prüfen

Wenn Sie eine Remote-Source mit SQL anlegen, sind zwei Prüfebenen verfügbar.

Remote-Quellenkonsistenz – Sperrung
Diese Prüfung erfolgt im Rahmen der SQL-Anweisung CREATE REMOTE SOURCE.
Die Remote-Source-Definition muss "syntaktisch" korrekt sein, wobei alle erforderlichen Parameter ausgefüllt sind.
Die Prüfung kann beispielsweise fehlschlagen, wenn Sie den Servernamen vergessen haben oder keinen gültigen Agentennamen in der AT LOCATION-Klausel angegeben haben (sofern zutreffend).
In diesem Fall schlägt die SQL-Anweisung fehl, und die Remote-Quelle kann nicht angelegt werden. Sie müssen die SQL-Anweisung ändern und erneut ausführen.
Remote-Source-Konnektivität – nicht blockierend
Diese Prüfung ist optional, nicht Teil der Anweisung CREATE REMOTE SOURCE.
Sie können eine zusätzliche SQL-Anweisung ausführen, um zu prüfen, ob die Remote-Source-Definition SAP HANA erlaubt, eine Verbindung zum Remote-System herzustellen und den Remote-Benutzer zu authentifizieren.
Code Snippet
```
1
CALL CHECK_REMOTE_SOURCE('<remote_source_name>');
```
Die Ausführung dieser Prozedur ist entweder erfolgreich (Prüfung bestanden), oder wenn sie fehlschlägt, erhalten Sie einige Details zur Grundursache in der SQL-Konsole.
Dies kann ein Fehler im Servernamen oder ggf. in der SAP-Cloud-Connector-Konfiguration sein, oder einfach die Tatsache, dass der Remote-Server derzeit nicht verfügbar ist. In anderen Kontexten kann dies daran liegen, dass die Remote-Quelle mit sekundären Anmeldeinformationen definiert ist, aber für Ihren Benutzer keine solchen Anmeldeinformationen vorhanden sind.

Next lesson