Menjalankan terjemahan batch menggunakan konektor Cloud Translation

Tutorial ini menunjukkan cara membuat alur kerja yang menggunakan konektor Cloud Translation API untuk menerjemahkan file ke bahasa lain dalam mode batch asinkron. Hal ini memberikan output real-time saat input diproses.

Buat bucket dan file Cloud Storage input

Anda dapat menggunakan Cloud Storage untuk menyimpan objek. Objek adalah bagian data yang tidak dapat diubah dan terdiri dari file dalam format apa pun, serta disimpan dalam penampung yang disebut bucket.

  1. Buat bucket Cloud Storage untuk menyimpan file yang akan diterjemahkan:

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

  2. Buat dua file dalam bahasa Inggris dan upload ke bucket input:

    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}

Men-deploy dan menjalankan alur kerja

Alur kerja terdiri dari serangkaian langkah yang dijelaskan menggunakan sintaksis Workflows, yang dapat ditulis dalam format YAML atau JSON. Ini adalah definisi alur kerja. Setelah membuat alur kerja, Anda men-deploy alur kerja tersebut agar tersedia untuk dieksekusi.

  1. Buat file teks dengan nama file workflow.yaml dan dengan konten berikut:

    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

    Alur kerja menetapkan variabel, membuat bucket output, dan memulai terjemahan file, lalu menyimpan hasilnya ke bucket output.

  2. Setelah membuat alur kerja, deploy alur kerja tersebut:

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

  3. Menjalankan alur kerja:

    gcloud workflows execute batch-translation

  4. Untuk melihat status alur kerja, Anda dapat menjalankan perintah yang ditampilkan. Contoh:

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

    Alur kerja harus ACTIVE. Setelah beberapa menit, file yang diterjemahkan (dalam bahasa Prancis dan Spanyol) akan diupload ke bucket output.

Mencantumkan objek di bucket output

Anda dapat mengonfirmasi bahwa alur kerja berfungsi seperti yang diharapkan dengan mencantumkan objek di bucket output Anda.

  1. Ambil nama bucket output Anda:

    gcloud storage ls

    Outputnya mirip dengan hal berikut ini: 

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

  2. Mencantumkan objek di bucket output Anda:

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

    Setelah beberapa menit, file yang diterjemahkan, masing-masing dua dalam bahasa Prancis dan Spanyol, akan tercantum.