Phrase Data (Orchestrator)

Le contenu est traduit de l’anglais par Phrase Language AI.

Seules les organisations disposant de Phrase Data dans leur abonnement pourront utiliser cette fonctionnalité.

Cas d'utilisation

Interrogez Phrase Data pour des projets ou des travaux Phrase TMS qui satisfont certaines conditions afin de faciliter les flux de travail d'échantillonnage ou de trouver des travaux qui pourraient nécessiter une attention particulière.
Déclenchez des actions basées sur des statistiques, par exemple lorsque suffisamment de mots sont traduits vers une certaine langue cible.

Prérequis

Pour Activer Phrase Orchestrator afin qu'il se connecte en toute sécurité à Phrase Data, suivez ces étapes :

Localisez l'identifiant de compte Phrase Data.

L'identifiant de compte Snowflake est utilisé pour configurer l'intégration dans Orchestrator. Il peut être trouvé dans l'interface utilisateur Web lors de la connexion à l'instance Phrase Data.
1. Se connecter à Phrase Data
2. Regardez l'URL dans le navigateur ; elle devrait avoir ce format : https://<account_identifier>.snowflakecomputing.com
  
  Exemple :
  
  Si l'URL est https://mz18723.eu-west-1.snowflakecomputing.com, l'identifiant de compte est mz18723.eu-west-1.
3. Copiez l'identifiant de compte pour une configuration ultérieure avec l'intégration Phrase Data dans Phrase Orchestrator.
Générez une paire de clés RSA.

Une paire de clés privée/publique est requise pour s'authentifier auprès de Phrase Data.
1. Sur la station de travail ou le serveur, exécutez les commandes suivantes :
```
# Générer la clé privée (non chiffrée, recommandée pour la compatibilité)
openssl genrsa -out rsa_key.p8 2048

# Générer la clé publique correspondante
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
```
2. La clé privée (rsa_key.p8) doit rester stockée en toute sécurité de votre côté et ne jamais être partagée.
3. La clé publique (rsa_key.pub) doit être partagée avec Phrase. Gardez ceci en note pour une utilisation ultérieure.
  
  La clé publique est un fichier texte qui doit ressembler à cet exemple :
  
  -----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwW2GmHZJ0m6aZq1v8fFz4SKjWl4TjA9mfx0MIfLtj4D4xBLv9jD1Iu3hT7sKn4D3gEVQPoB6MtiEhpx7F7QhvO7FQ8q2rJt3xEwVZ2Kohmz6FZ7P/0dYbGqAfd7nPtum6GLeA+E+Tf9X91GnGl6xKp0MeDqB4oZn3mC8Xt9jR0A9TmFfqpy1mJQFzF0oKhRUgD9lY7sLX6XU0otf6jNerOnqM6JtWvA5Bp2q5nfh7VfJjKZ5Zm7YnxGRF9NfXqJx6woL7JBoqLZTz4TRl7pCoj5bnLWJah8UhwB6vD3mW+OsoSgj6H1L5PRwP0hNsy7m4d9JZ+Y8rYFRmgSGxjM40QIDAQAB-----END PUBLIC KEY-----
Partagez la clé publique avec Phrase.
1. Envoyez le fichier de clé publique (rsa_key.pub) à Phrase en toute sécurité (n'envoyez pas la clé privée) par e-mail ou via un canal Slack dédié.
  
  Envoyez une adresse e-mail où Phrase peut envoyer le nom de l'utilisateur de service après l'avoir configuré.
  
  Contactez le support technique ou vos architectes de solutions pour plus de détails sur les adresses de contact.
2. Phrase enregistrera la clé publique dans Phrase Data pour l'utilisateur de service dédié. Un e-mail est envoyé à l'adresse fournie, qui contiendra un nom d'utilisateur dédié.
3. Phrase activera l'accès à l'intégration dans Phrase Orchestrator.

Configurer l'intégration Phrase Data dans Phrase Orchestrator

Pour configurer l'intégration, suivez ces étapes :

Cliquez sur Intégrations dans la barre de navigation latérale.

La page Intégrations s'ouvre.
Cliquez sur Ajouter intégration.

La fenêtre Ajouter une nouvelle intégration s'affiche.
Cliquez sur Phrase Data.

La fenêtre de compte est affichée.
Renseignez les informations suivantes :
- Identifiant de compte
  
  Utiliser l'identifiant de compte de l'étape 1 dans la section des prérequis
- Nom d'utilisateur
  
  Utiliser le nom d'utilisateur Phrase Data de l'étape 3 dans la section des prérequis
- Private Key (PEM)
  
  Utiliser le contenu de la clé privée de l'étape 2 dans la section des prérequis
Cliquez sur Enregistrer.

La nouvelle intégration est affichée sur la page Integrations.

Ajouter une Action de flux de travaux pour effectuer une requête Phrase Data dans Phrase Orchestrator

Pour effectuer une requête Phrase Data depuis un flux de travaux Phrase Orchestrator, suivez ces étapes :

Depuis l'onglet éditeur d'une page de flux de travaux, saisissez Send HTTP Request dans le champ de recherche Actions.

Renommez-le en Execute SQL Statement ou similaire.
Cliquez sur la tuile d'action dans le flux de travaux et Sélectionner Edit parameters depuis l'onglet Parameters sur le côté droit.
Saisissez ces valeurs :
- URL :
  
  https://<Identifiant de compte>.snowflakecomputing.com/api/v2/statements
- Action :
  
  POST
- Data :
```
{     
"statement": "<SQL statement>",     
"warehouse": "MEMSOURCE"   
}
```
  Le nom de l'entrepôt n'est pas le même pour toutes les instances. Dans les configurations plus récentes, il est nommé Phrase.
  
  Modifier la variable <SQL statement> par une requête significative. Par exemple :
```
{
"statement": "sélectionner TOP 10 * FROM memsource.org_154.acheteur_V2",
"warehouse": "MEMSOURCE"
}
```
  Le nom de la base de données n'est pas le même pour toutes les instances. Pour référence les tables dans la clause FROM, utiliser le nom de base de données correct (les clients plus récents l'ont nommé Phrase), et fournir le nom de schéma correct au format org_<number>.
- En-tête :
  
  Nom : Authorization
  
  Valeur : Bearer {{ @var.snowflake_token }}
  
  Utiliser Field Picker pour récupérer la valeur Bearer.
Cliquer sur Enregistrer les paramètres pour confirmer les paramètres.