Phrase Data (Orchestrator)

文本由 Phrase Language AI 从英语机器翻译而得。

只有在订购套餐中包含 Phrase Data 的组织才能使用此功能。

使用场景示例

查询 Phrase Data 以获取满足特定条件的 Phrase TMS 项目或任务，从而促进抽样工作流程或查找可能需要特别提醒的任务。
触发基于统计信息的操作，例如当足够的词数被翻译成特定目标语言时。

先决条件

要启用 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. 通过电子邮件或专用 Slack 频道安全地将公钥文件 (rsa_key.pub) 发送给 Phrase（请勿发送私钥）。
  
  发送一个电子邮件地址，以便 Phrase 在设置完成后可以发送服务用户的名称。
  
  有关联系地址的更多详细信息，请联系技术支持或您的解决方案架构师。
2. Phrase 将在 Phrase Data 中为专用服务用户注册公钥。一封电子邮件将发送至所提供的地址，其中包含专用用户名。
3. Phrase 将激活 Phrase Orchestrator 中对该集成的访问权限。

在 Phrase Orchestrator 中配置 Phrase Data 集成

要设置该集成，请按照以下步骤操作：

从导航侧边栏点击 Integrations。

Integrations 页面随即打开。
点击 Add Integration。

Add new integration 窗口随即显示。
点击 Phrase Data。

账户窗口随即显示。
提供：
- 账户标识符
  
  请使用先决条件部分步骤 1 中提供的账户标识符。
- 用户名
  
  使用步骤 3 中先决条件部分的 Phrase Data 用户名。
- 私钥 (PEM)
  
  使用步骤 2 中先决条件部分的私钥内容。
点击保存。

新的集成显示在 Integrations 页面上。

添加一个工作流操作以在 Phrase Orchestrator 中查询 Phrase Data

要从 Phrase Orchestrator 工作流中查询 Phrase Data，请按照以下步骤操作：

在工作流页面的 Editor 选项卡中，在 Actions 搜索字段中输入 Send HTTP Request。

将其重命名为 Execute SQL Statement 或类似名称。
点击工作流中的操作磁贴，然后从右侧的 Parameters 选项卡中选择 Edit parameters。
输入以下值：
- URL：
  
  https://<account ID>.snowflakecomputing.com/api/v2/statements
- 操作：
  
  POST
- 数据：
```
{     
"statement": "<SQL statement>",    
"warehouse": "MEMSOURCE"   
}
```
  仓库名称并非在所有实例中都相同。在较新的设置中，它被命名为 PHRASE。
  
  将 <SQL statement> 变量更改为有意义的查询。例如：
```
{
"statement": "SELECT TOP 10 * FROM memsource.org_154.BUYER_V2",
"warehouse": "MEMSOURCE"
}
```
  数据库名称并非在所有实例中都相同。若要参考 FROM 子句中的表，请使用正确的数据库名称（较新的客户将其命名为 PHRASE），并以 org_<number> 的格式提供正确的架构名称。
- 标题：
  
  名称：授权
  
  值：Bearer {{ @var.snowflake_token }}
  
  使用字段选择器来检索 Bearer 值。
点击保存参数以确认设置。