使用 Cloud Translation 连接器运行批量翻译

本教程介绍了如何创建一个工作流，该工作流使用 Cloud Translation API 连接器在异步批量模式下将文件翻译为其他语言。这样一来，系统便可在处理输入内容的同时提供实时输出。

创建输入 Cloud Storage 存储桶和文件

您可以使用 Cloud Storage 存储对象。对象是由任意格式的文件组成的不可变的数据段，存储在称为存储分区的容器中。

  1. 创建 Cloud Storage 存储桶以保存要翻译的文件：

    BUCKET_INPUT=${GOOGLE_CLOUD_PROJECT}-input-files
gcloud storage buckets create gs://${BUCKET_INPUT}

  2. 使用英语创建两个文件，并将它们上传到输入存储桶：

    echo "Hello World!" > file1.txt
gcloud storage cp file1.txt gs://${BUCKET_INPUT}
echo "Workflows connectors simplify calling services." > file2.txt
gcloud storage cp file2.txt gs://${BUCKET_INPUT}

部署和执行工作流

工作流由一系列使用 Workflows 语法描述的步骤组成，该语法可以采用 YAML 或 JSON 格式编写。这是工作流的定义。创建工作流后，可以进行部署，使其可以执行。

  1. 创建一个文件名为 workflow.yaml 且包含以下内容的文本文件：

    main:
  steps:
  - init:
      assign:
      - projectId: ${sys.get_env("GOOGLE_CLOUD_PROJECT_ID")}
      - location: ${sys.get_env("GOOGLE_CLOUD_LOCATION")}
      - inputBucketName: ${projectId + "-input-files"}
      - outputBucketName: ${projectId + "-output-files-" + string(int(sys.now()))}
  - createOutputBucket:
        call: googleapis.storage.v1.buckets.insert
        args:
          project: ${projectId}
          body:
            name: ${outputBucketName}
  - batchTranslateText:
      call: googleapis.translate.v3beta1.projects.locations.batchTranslateText
      args:
          parent: ${"projects/" + projectId + "/locations/" + location}
          body:
              inputConfigs:
                gcsSource:
                  inputUri: ${"gs://" + inputBucketName + "/*"}
              outputConfig:
                  gcsDestination:
                    outputUriPrefix: ${"gs://" + outputBucketName + "/"}
              sourceLanguageCode: "en"
              targetLanguageCodes: ["es", "fr"]
      result: batchTranslateTextResult

    工作流会分配变量、创建输出存储桶并启动文件翻译，并将结果保存到输出存储桶。

  2. 创建工作流后，请部署该工作流：

    gcloud workflows deploy batch-translation --source=workflow.yaml

  3. 执行工作流：

    gcloud workflows execute batch-translation

  4. 如需查看工作流状态，您可以运行返回的命令。例如：

    gcloud workflows executions describe eb4a6239-cffa-4672-81d8-d4caef7d8424 /
  --workflow batch-translation /
  --location us-central1

    工作流应为 ACTIVE。几分钟后，翻译后的文件（法语和西班牙语）会上传到输出存储桶。

列出输出存储桶中的对象

通过列出输出存储桶中的对象，您可以确认工作流是否按预期工作。

  1. 检索输出存储桶名称：

    gcloud storage ls

    输出类似于以下内容： 

    gs://PROJECT_ID-input-files/
gs://PROJECT_ID-output-files-TIMESTAMP/

  2. 列出输出存储桶中的对象：

    gcloud storage ls gs://PROJECT_ID-output-files-TIMESTAMP/** --recursive

    几分钟后，系统会列出翻译后的文件，每种语言（法语和西班牙语）各两个。