Phrase Data (Orchestrator)

本コンテンツはPhrase Language AIの機械翻訳により、英語から翻訳されています。

サブスクリプションにPhrase Dataが含まれている組織のみが、この機能を使用できます。

使用例

Phrase TMSのプロジェクトやジョブのPhrase Dataをクエリして特定の条件を満たすものを検索し、サンプリングワークフローを促進したり、特別な対応が必要なジョブを見つけたりします。
統計に基づいたアクションをトリガーします（例：特定の訳文言語への翻訳が一定数に達したとき）。

前提条件

Phrase OrchestratorがPhrase Dataに安全に接続できるようにするには、以下の手順に従ってください。

Phrase Dataのアカウント識別子を確認します。

Snowflakeのアカウント識別子は、Orchestratorで統合機能を設定するために使用されます。Phrase Dataインスタンスにサインインすると、Web UIで確認できます。
1. Phrase Dataにサインイン
2. ブラウザのURLを確認してください。形式は https://<account_identifier>.snowflakecomputing.com となっているはずです。
  
  例：
  
  URLが https://mz18723.eu-west-1.snowflakecomputing.com の場合、アカウント識別子は mz18723.eu-west-1 です。
3. Phrase OrchestratorのPhrase Data統合機能で後ほど設定するために、アカウント識別子をコピーします。
RSAキーペアを生成します。

Phrase Dataで認証を行うには、プライベート/パブリックキーペアが必要です。
1. ワークステーションまたはサーバーで、次のコマンドを実行します。
```
# プライベートキーを生成（暗号化なし、互換性のために推奨）
openssl genrsa -out rsa_key.p8 2048

# 対応するパブリックキーを生成
openssl rsa -in rsa_key.p8 -pubout -out rsa_key.pub
```
2. プライベートキー（rsa_key.p8）は、お客様側で安全に保管し、決して共有しないでください。
3. パブリックキー（rsa_key.pub）は、Phraseと共有する必要があります。これは後の使用のために控えておいてください。
  
  公開キーは、次の例のような形式のテキストファイルです。
  
  -----BEGIN PUBLIC KEY-----MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAwW2GmHZJ0m6aZq1v8fFz4SKjWl4TjA9mfx0MIfLtj4D4xBLv9jD1Iu3hT7sKn4D3gEVQPoB6MtiEhpx7F7QhvO7FQ8q2rJt3xEwVZ2Kohmz6FZ7P/0dYbGqAfd7nPtum6GLeA+E+Tf9X91GnGl6xKp0MeDqB4oZn3mC8Xt9jR0A9TmFfqpy1mJQFzF0oKhRUgD9lY7sLX6XU0otf6jNerOnqM6JtWvA5Bp2q5nfh7VfJjKZ5Zm7YnxGRF9NfXqJx6woL7JBoqLZTz4TRl7pCoj5bnLWJah8UhwB6vD3mW+OsoSgj6H1L5PRwP0hNsy7m4d9JZ+Y8rYFRmgSGxjM40QIDAQAB-----END PUBLIC KEY-----
公開キーを Phrase と共有してください。
1. 公開キーファイル (rsa_key.pub) を、メールまたは専用の Slack チャンネル経由で安全に Phrase に送信してください（秘密キーは送信しないでください）。
  
  サービスユーザーの設定完了後に、Phrase がその名前を送信できるメールアドレスをお知らせください。
  
  連絡先アドレスの詳細については、テクニカルサポートまたはソリューションアーキテクトにお問い合わせください。
2. Phrase は、専用サービスユーザーのために Phrase Data に公開キーを登録します。提供されたアドレスにメールが送信され、専用のユーザー名が記載されます。
3. Phrase は Phrase Orchestrator で統合機能へのアクセスを有効にします。

Phrase Orchestrator で Phrase Data 統合機能を設定します

統合機能を設定するには、以下の手順に従ってください。

ナビゲーションサイドバーから統合機能をクリックします。

統合機能ページが開きます。
統合を追加をクリックします。

新しい統合を追加ウィンドウが表示されます。
Phrase Data をクリックします。

アカウントウィンドウが表示されます。
提供：
- アカウント識別子
  
  前提条件セクションのステップ1のアカウント識別子を使用します。
- ユーザー名
  
  前提条件セクションのステップ3のPhrase Dataユーザー名を使用します。
- プライベートキー (PEM)
  
  前提条件セクションのステップ2のプライベートキーのコンテンツを使用します。
保存をクリックします。

新しい統合機能が統合機能ページに表示されます。

Phrase OrchestratorでPhrase Dataをクエリするためのワークフローアクションを追加します。

Phrase OrchestratorワークフローからPhrase Dataをクエリするには、以下のステップに従います。

ワークフローページのエディタタブから、アクション検索フィールドにHTTPリクエストを送信と入力します。

SQLステートメントを実行などに名前を変更します。
ワークフロー内のアクションタイルをクリックし、右側のパラメータタブからパラメータを編集を選択します。
以下の値を入力します。
- URL:
  
  https://<account ID>.snowflakecomputing.com/api/v2/statements
- アクション:
  
  POST
- データ:
```
{     
"statement": "<SQL statement>",    
"warehouse": "MEMSOURCE"   
}
```
  ウェアハウス名はすべてのインスタンスで同じではありません。より新しいセットアップでは、名前はPHRASEとなっています。
  
  <SQLステートメント>変数を意味のあるクエリに変更します。以下に例を挙げます。
```
{
"statement": "SELECT TOP 10 * FROM memsource.org_154.BUYER_V2",
"warehouse": "MEMSOURCE"
}
```
  データベース名はすべてのインスタンスで同じではありません。FROM句でテーブルを参照するには、正しいデータベース名（最近の顧客はPHRASEという名前になっています）を使用し、org_<number>という形式で正しいスキーマ名を指定してください。
- ヘッダー:
  
  名前: Authorization
  
  値: Bearer {{ @var.snowflake_token }}
  
  Field Pickerを使用してBearer値を取得します。
Save parametersをクリックして設定を確定します。