Phrase Data (Orchestrator)

Inhalte werden von Phrase Language AI maschinell aus dem Englischen übersetzt.

Nur Organisationen mit Phrase Data im Abonnement können diese Funktion verwenden.

Anwendungsfälle

Phrase Data für Phrase TMS-Projekte oder -Jobs abfragen, die bestimmte Bedingungen erfüllen, um Sampling-Workflows zu erleichtern oder Jobs zu identifizieren, die einen speziellen Anstoß benötigen.
Auf Statistiken basierende Aktionen auslösen, z. B. wenn genügend Wörter in eine bestimmte Zielsprache übersetzt wurden.

Voraussetzungen

Um eine sichere Verbindung von Phrase Orchestrator zu Phrase Data zu ermöglichen, sind die folgenden Schritte zu befolgen:

Den Konto-Identifier des Phrase Data-Kontos ermitteln.

Der Snowflake-Konto-Identifier dient zur Konfiguration der Integration in Orchestrator. Er ist in der Web-UI während der Anmeldung an der Phrase Data-Instanz zu finden.
1. Bei Phrase Data anmelden
2. Die URL im Browser ansehen; sie sollte dieses Format haben: https://<account_identifier>.snowflakecomputing.com
  
  Beispiel:
  
  Wenn die URL https://mz18723.eu-west-1.snowflakecomputing.com ist, ist der Konto-Identifier mz18723.eu-west-1.
3. Den Konto-Identifier für die spätere Konfiguration mit der Phrase Data-Integration in Phrase Orchestrator kopieren.
Ein RSA-Key-Paar generieren.

Ein privates/öffentliches Key-Paar wird zur Authentifizierung bei Phrase Data benötigt.
1. Auf der Workstation oder dem Server sind folgende Befehle auszuführen:
```
# Privaten Key generieren (ohne Verschlüsselung, empfohlen zur Gewährleistung der Kompatibilität)
openssl genrsa -out rsa_key.p8 2048

# Den entsprechenden öffentlichen Key generieren
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
```
2. Der private Key (rsa_key.p8) sollte sicher gespeichert bleiben und niemals geteilt werden.
3. Der öffentliche Key (rsa_key.pub) sollte mit Phrase geteilt werden. Für die spätere Verwendung notieren.
  
  Der öffentliche Key ist eine Textdatei, die ähnlich wie dieses Beispiel aussehen sollte:
  
  -----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwW2GmHZJ0m6aZq1v8fFz4SKjWl4TjA9mfx0MIfLtj4D4xBLv9jD1Iu3hT7sKn4D3gEVQPoB6MtiEhpx7F7QhvO7FQ8q2rJt3xEwVZ2Kohmz6FZ7P/0dYbGqAfd7nPtum6GLeA+E+Tf9X91GnGl6xKp0MeDqB4oZn3mC8Xt9jR0A9TmFfqpy1mJQFzF0oKhRUgD9lY7sLX6XU0otf6jNerOnqM6JtWvA5Bp2q5nfh7VfJjKZ5Zm7YnxGRF9NfXqJx6woL7JBoqLZTz4TRl7pCoj5bnLWJah8UhwB6vD3mW+OsoSgj6H1L5PRwP0hNsy7m4d9JZ+Y8rYFRmgSGxjM40QIDAQAB-----END PUBLIC KEY-----
Der öffentliche Key wird mit Phrase geteilt.
1. Die öffentliche Key-Datei (rsa_key.pub) wird sicher an Phrase gesendet (der private Key darf nicht gesendet werden), entweder per E-Mail oder über einen dedizierten Slack-Kanal.
  
  Eine E-Mail-Adresse angeben, an die Phrase den Namen des Service Users senden kann, nachdem dieser eingerichtet wurde.
  
  Für weitere Details zu Kontaktadressen kann der technische Support oder das Solutions Architects Team kontaktiert werden.
2. Der öffentliche Key wird in Phrase Data für den dedizierten Service User registriert. Eine E-Mail wird an die angegebene Adresse gesendet, die einen dedizierten Benutzernamen enthält.
3. Der Zugriff auf die Integration in Phrase Orchestrator wird aktiviert.

Die Phrase Data-Integration wird in Phrase Orchestrator konfiguriert.

Um die Integration einzurichten, sind folgende Schritte auszuführen:

Im Navigationsmenü wird Integrations ausgewählt.

Die Integrations-Seite wird geöffnet.
Die Option Add Integration auswählen.

Das Fenster Add new integration wird angezeigt.
Phrase Data wird ausgewählt.

Das Konto-Fenster wird angezeigt.
Stelle Folgendes bereit:
- Account identifier
  
  Den Account identifier aus Schritt 1 des Abschnitts Voraussetzungen verwenden.
- Benutzername
  
  Den Phrase Data-Benutzernamen aus Schritt 3 des Abschnitts Voraussetzungen verwenden.
- Private Key (PEM)
  
  Den Inhalt des Private Key (PEM) aus Schritt 2 des Abschnitts Voraussetzungen verwenden.
Klicke auf Importieren.

Die neue Integration wird auf der Integrations-Seite angezeigt.

Eine Workflow-Aktion hinzufügen, um Phrase Data in Phrase Orchestrator abzufragen.

Um Phrase Data aus einem Phrase Orchestrator-Workflow abzufragen, sind folgende Schritte auszuführen:

Im Editor-Tab einer Workflow-Seite im Suchfeld Actions den Begriff Send HTTP Request eingeben.

Es wird in Execute SQL Statement oder ähnlich umbenannt.
Die Aktionskachel im Workflow wird ausgewählt und Edit parameters im Parameters-Tab auf der rechten Seite ausgewählt.
Diese Werte eingeben:
- URL:
  
  https://<account ID>.snowflakecomputing.com/api/v2/statements
- Action:
  
  POST
- Data:
```
{     
"statement": "<SQL statement>",     
"warehouse": "MEMSOURCE"   
}
```
  Der Name des Warehouses ist nicht bei allen Instanzen gleich. In neueren Setups heißt es PHRASE.
  
  Die Variable <SQL statement> in eine aussagekräftige Abfrage umwandeln. Beispiel:
```
{
"statement": "SELECT TOP 10 * FROM memsource.org_154.BUYER_V2",
"warehouse": "MEMSOURCE"
}
```
  Der Name der Datenbank ist nicht für alle Instanzen gleich. Um die Tabellen in der FROM-Klausel anzusprechen, den korrekten Datenbanknamen (bei neueren Kunden PHRASE) sowie den korrekten Schemanamen im Format org_<number> angeben.
- Header:
  
  Name: Authorization
  
  Wert: Bearer {{ @var.snowflake_token }}
  
  Mit Field Picker lässt sich der Bearer-Wert abrufen.
Mit einem Klick auf Parameter speichern werden die Einstellungen bestätigt.