Phrase Data (Orchestrator)

O conteúdo de toda a Central de Ajuda é traduzido automaticamente de inglês pelo Phrase Language AI.

Apenas organizações com Phrase Data em sua assinatura poderão usar este recurso.

Casos de uso

Consultar Phrase Data para projetos ou trabalhos do Phrase TMS que satisfaçam certas condições para facilitar fluxos de trabalho de amostragem ou encontrar trabalhos que possam precisar de um incentivo especial.
Acionar ações baseadas em estatísticas, por exemplo, quando palavras suficientes são traduzidas para um determinado idioma de tradução.

Pré-requisitos

Para Ativar o Phrase Orchestrator para se conectar com segurança ao Phrase Data, siga estas etapas:

Localize o identificador da conta do Phrase Data.

O identificador da conta do Snowflake é usado para configurar a integração no Orchestrator. Ele pode ser encontrado na interface da web ao entrar na instância do Phrase Data.
1. Entrar no Phrase Data
2. Observe a URL no navegador; ela deve ter este formato: https://<account_identifier>.snowflakecomputing.com
  
  Exemplo:
  
  Se a URL for https://mz18723.eu-west-1.snowflakecomputing.com, o identificador da conta é mz18723.eu-west-1.
3. Copie o identificador da conta para configuração posterior com a integração do Phrase Data no Phrase Orchestrator.
Gere um par de chaves RSA.

Um par de chaves público/privado é necessário para autenticar com o Phrase Data.
1. Na estação de trabalho ou servidor, execute os seguintes comandos:
```
# Gerar chave privada (não criptografada, recomendada para compatibilidade)
openssl genrsa -out rsa_key.p8 2048

# Gerar a chave pública correspondente
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
```
2. A chave privada (rsa_key.p8) deve permanecer armazenada com segurança do seu lado e nunca ser compartilhada.
3. A chave pública (rsa_key.pub) deve ser compartilhada com a Phrase. Mantenha isso anotado para usar mais tarde.
  
  A chave pública é um arquivo de texto que deve ser semelhante a este exemplo:
  
  -----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwW2GmHZJ0m6aZq1v8fFz4SKjWl4TjA9mfx0MIfLtj4D4xBLv9jD1Iu3hT7sKn4D3gEVQPoB6MtiEhpx7F7QhvO7FQ8q2rJt3xEwVZ2Kohmz6FZ7P/0dYbGqAfd7nPtum6GLeA+E+Tf9X91GnGl6xKp0MeDqB4oZn3mC8Xt9jR0A9TmFfqpy1mJQFzF0oKhRUgD9lY7sLX6XU0otf6jNerOnqM6JtWvA5Bp2q5nfh7VfJjKZ5Zm7YnxGRF9NfXqJx6woL7JBoqLZTz4TRl7pCoj5bnLWJah8UhwB6vD3mW+OsoSgj6H1L5PRwP0hNsy7m4d9JZ+Y8rYFRmgSGxjM40QIDAQAB-----END PUBLIC KEY-----
Compartilhe a chave pública com a Phrase.
1. Envie o arquivo da chave pública (rsa_key.pub) para a Phrase com segurança (não envie a chave privada) via e-mail ou um canal dedicado do Slack.
  
  Envie um endereço de e-mail para onde a Phrase possa enviar o nome do usuário de serviço após configurá-lo.
  
  Entre em contato com o Suporte Técnico ou com seus Arquitetos de Soluções para obter mais detalhes sobre os endereços de contato.
2. A Phrase registrará a chave pública no Phrase Data para o usuário de serviço dedicado. Um e-mail é enviado para o endereço fornecido, o qual conterá um nome de usuário dedicado.
3. A Phrase ativará o acesso à integração no Phrase Orchestrator.

Configurar a integração do Phrase Data no Phrase Orchestrator

Para configurar a integração, siga estas etapas:

Clique em Integrações na barra lateral de navegação.

A página Integrações é aberta.
Clique em Adicionar integração.

A janela Adicionar nova integração é exibida.
Clique em Phrase Data.

A janela da conta é exibida.
Forneça:
- Identificador da conta
  
  Usar o identificador da conta da etapa 1 na seção de pré-requisitos
- Nome de usuário
  
  Usar o nome de usuário do Phrase Data da etapa 3 na seção de pré-requisitos
- Chave privada (PEM)
  
  Usar o conteúdo da chave privada da etapa 2 na seção de pré-requisitos
Clique em Gravar.

A nova integração é exibida na página Integrations.

Adicionar uma Ação de fluxo de trabalho para consultar Phrase Data no Phrase Orchestrator

Para consultar Phrase Data de um fluxo de trabalho do Phrase Orchestrator, siga estas etapas:

Na aba Editor de uma página de fluxo de trabalho, insira Send HTTP Request no campo de pesquisa Actions.

Renomeie-o para Execute SQL Statement ou similar.
Clique no bloco de ação no fluxo de trabalho e Selecionar Edit parameters na aba Parameters no lado direito.
Insira estes valores:
- URL:
  
  https://<ID da conta>.snowflakecomputing.com/api/v2/statements
- Ação:
  
  POST
- Dados:
```
{     
"statement": "<SQL statement>",     
"warehouse": "MEMSOURCE"   
}
```
  O nome do armazém não é o mesmo para todas as instâncias. Em configurações mais recentes, ele é nomeado Phrase.
  
  Altere a variável <SQL statement> para uma consulta significativa. Por exemplo:
```
{
"statement": "selecionar TOP 10 * FROM memsource.org_154.comprador_V2",
"warehouse": "MEMSOURCE"
}
```
  O nome do banco de dados não é o mesmo para todas as instâncias. Para fazer referência às tabelas na cláusula FROM, usar o nome correto do banco de dados (clientes mais recentes o têm nomeado Phrase) e fornecer o nome correto do esquema no formato de org_<number>.
- Cabeçalho:
  
  Nome: Authorization
  
  Valor: Bearer {{ @var.snowflake_token }}
  
  Usar Field Picker para recuperar o valor Bearer.
Clique em Save parameters para confirmar as configurações.