Phrase Data (Orchestrator)

Contenuti tradotti automaticamente dall'inglese con Phrase Language AI.

Solo le organizzazioni con Phrase Data nel loro abbonamento possono usare questa funzionalità.

Casi d'uso

Esegui una query su Phrase Data per progetti o lavori di Phrase TMS che soddisfano determinate condizioni, per facilitare i workflow di campionamento o individuare lavori che potrebbero aver bisogno di un piccolo stimolo.
Attiva azioni basate sulle statistiche, ad esempio quando abbastanza parole sono state tradotte in una certa lingua di destinazione.

Prerequisiti

Per abilitare Phrase Orchestrator a connettersi in modo sicuro a Phrase Data, segui questi passaggi:

Trova l'identificatore dell'account di Phrase Data.

L'identificatore dell'account di Snowflake viene utilizzato per configurare l'integrazione in Orchestrator. Lo trovi nell'interfaccia web quando accedi all'istanza di Phrase Data.
1. Accedi a Phrase Data
2. Guarda l'URL nel browser: dovrebbe avere questo formato: https://<account_identifier>.snowflakecomputing.com
  
  Esempio:
  
  Se l'URL è https://mz18723.eu-west-1.snowflakecomputing.com, l'identificatore dell'account è mz18723.eu-west-1.
3. Copia l'identificatore dell'account per la successiva configurazione dell'integrazione di Phrase Data in Phrase Orchestrator.
Generare una coppia di chiavi RSA.

Serve una coppia di chiavi privata/pubblica per autenticarti con Phrase Data.
1. Sulla workstation o sul server, esegui questi comandi:
```
# Generare la chiave privata (non crittografata, consigliata per la compatibilità)
openssl genrsa -out rsa_key.p8 2048

# Generare la chiave pubblica corrispondente
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
```
2. La chiave privata (rsa_key.p8) deve essere conservata in modo sicuro e non deve essere mai condivisa.
3. La chiave pubblica (rsa_key.pub) deve essere condivisa con Phrase. Tieni nota di questo per un uso successivo.
  
  La chiave pubblica è un file di testo che dovrebbe apparire simile a questo esempio:
  
  -----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwW2GmHZJ0m6aZq1v8fFz4SKjWl4TjA9mfx0MIfLtj4D4xBLv9jD1Iu3hT7sKn4D3gEVQPoB6MtiEhpx7F7QhvO7FQ8q2rJt3xEwVZ2Kohmz6FZ7P/0dYbGqAfd7nPtum6GLeA+E+Tf9X91GnGl6xKp0MeDqB4oZn3mC8Xt9jR0A9TmFfqpy1mJQFzF0oKhRUgD9lY7sLX6XU0otf6jNerOnqM6JtWvA5Bp2q5nfh7VfJjKZ5Zm7YnxGRF9NfXqJx6woL7JBoqLZTz4TRl7pCoj5bnLWJah8UhwB6vD3mW+OsoSgj6H1L5PRwP0hNsy7m4d9JZ+Y8rYFRmgSGxjM40QIDAQAB-----END PUBLIC KEY-----
Condividi la chiave pubblica con Phrase.
1. Invia il file della chiave pubblica (rsa_key.pub) a Phrase in modo sicuro (non inviare la chiave privata) tramite e-mail o un canale Slack dedicato.
  
  Invia un indirizzo e-mail a cui Phrase può inviare il nome dell'utente del servizio dopo averlo configurato.
  
  Contatta il supporto tecnico o i tuoi Solutions Architect per ulteriori dettagli sugli indirizzi di contatto.
2. Phrase registrerà la chiave pubblica in Phrase Data per l'utente del servizio dedicato. Viene inviata un'e-mail all'indirizzo fornito che conterrà un nome utente dedicato.
3. Phrase attiverà l'accesso all'integrazione in Phrase Orchestrator.

Configura l'integrazione di Phrase Data in Phrase Orchestrator.

Per configurare l'integrazione, segui questi passaggi:

Clicca su Integrations dalla barra di navigazione laterale.

Si apre la pagina Integrations.
Clicca su Add Integration.

Si apre la finestra Add new integration.
Clicca su Phrase Data.

Si apre la finestra dell'account.
Indica:
- Identificatore dell'account
  
  Usa l'identificatore dell'account del passaggio 1 nella sezione dei prerequisiti.
- Nome utente
  
  Usa il nome utente Phrase Data del passaggio 3 nella sezione dei prerequisiti
- Chiave privata (PEM)
  
  Usa il contenuto della chiave privata del passaggio 2 nella sezione dei prerequisiti
Clicca su Salva.

La nuova integrazione viene visualizzata nella pagina Integrations.

Aggiungi un'azione al flusso di lavoro per interrogare Phrase Data in Phrase Orchestrator.

Per interrogare Phrase Data da un flusso di lavoro in Phrase Orchestrator, segui questi passaggi:

Dalla scheda Editor di una pagina flusso di lavoro, inserisci Send HTTP Request nel campo di ricerca Actions.

Rinominalo in Execute SQL Statement o simile.
Clicca sul riquadro azione nel flusso di lavoro e seleziona Edit parameters dalla scheda Parameters sul lato destro.
Inserisci questi valori:
- URL:
  
  https://<account ID>.snowflakecomputing.com/api/v2/statements
- Azione:
  
  POST
- Data:
```
{     
"statement": "<SQL statement>",     
"warehouse": "MEMSOURCE"   
}
```
  Il nome del warehouse non è lo stesso per tutte le istanze. Nelle configurazioni più recenti è denominato PHRASE.
  
  Modifica la variabile <SQL statement> con una query significativa. Ad esempio:
```
{
"statement": "SELECT TOP 10 * FROM memsource.org_154.BUYER_V2",
"warehouse": "MEMSOURCE"
}
```
  Il nome del database non è lo stesso per tutte le istanze. Per fare riferimento alle tabelle nella clausola FROM, usa il nome corretto del database (i clienti più recenti lo hanno denominato PHRASE) e fornisci il nome corretto dello schema nel formato org_<number>.
- Intestazione:
  
  Nome: Autorizzazione
  
  Valore: Bearer {{ @var.snowflake_token }}
  
  Usa Selettore di campi per recuperare il valore Bearer.
Clicca su Save parameters per confermare le impostazioni.