翻訳のトラブルシューティング

以降のセクションでは、Vertex AI Translation エラーのトラブルシューティングを行うためにユーザーが実行できる手順について説明します。

AITR2030 - TranslationServiceInvalidArgument

翻訳サービス リクエストの引数が無効です。これは、リクエストの無効な引数に対するデフォルトのエラーコードです。詳しくは、エラーの詳細とログをご覧ください。

AITR2031 - TextTranslationInvalidArgument

テキスト変換リクエストの引数が無効です。

エラー メッセージの例:

  • 翻訳リクエストの内容が空です。

    • 翻訳リクエストの contents フィールドが空です。
    • リクエストの contents フィールドに文のテキストを追加します。

  • mime_type パラメータが無効です。

    • 翻訳リクエストの mime_type フィールドが無効です。
    • サポートされる値は text/plain と text/html です。
    • mime_type フィールドが空の場合、デフォルト値は text/html です。

  • サポートされていない言語ペアです。

    • 移行元と移行先の言語ペアが Translation サービスでサポートされていない。
    • ターゲット言語は英語にする必要があります。ソース言語の一覧については、サポートされている言語をご覧ください。
    • getSupportedLanguages メソッドは、サポートされているすべての言語を返します。

  • 言語が空です。

    • リクエストのソース言語コードまたはターゲット言語コードが空です。
    • 翻訳リクエストのソース言語コード フィールドまたはターゲット言語コード フィールドを確認し、空でないことを確認します。ソース言語とコードのリストについては、サポートされている言語をご覧ください。

  • 不明な言語。

    • リクエストのソース言語コードまたはターゲット言語コードが BCP-47 言語コードではなく、無効です。
    • 翻訳リクエストのソース言語コード フィールドまたはターゲット言語コード フィールドを確認し、BCP-47 言語コードが使用されていることを確認します。

AITR2033 - GlossaryInvalidArgument

用語集リクエストの引数が無効です。

エラー メッセージの例:

  • 用語集名が無効です。

    • 用語集の名前または GET HTTP URL の形式が正しくありません。たとえば、正しい形式は projects/PROJECT_ID/glossaries/GLOSSARY_ID です。
    • gRPC を使用している場合は、リクエストの用語集フィールドの形式を確認します。
    • GET HTTP を使用している場合は、URL が /v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID の形式になっていることを確認してください。

  • プロジェクト名が無効です。

    • プロジェクト名の形式が正しくありません。誤った形式の例は projects/PROJECT_ID です。HTTP URL の場合、形式が正しくない例として projects/PROJECT_ID/glossaries があります。
    • gRPC を使用している場合は、リクエストの親フィールドの値を確認して、形式が正しいことを確認します。
    • HTTP を使用している場合は、URL が正しいことを確認してください。たとえば、正しい形式は /v1alpha1/projects/PROJECT_ID/glossaries です。

  • フィルタが無効です。

    • 用語集リストのフィルタが無効です。用語集リストのフィルタでは、ソース言語とターゲット言語によるフィルタリングのみがサポートされています。たとえば、src=frまたは src=frおよび tgt=en。
    • gRPC を使用している場合は、リクエストのフィルタ フィールドを確認し、正しいことを確認します。
    • GET HTTP を使用している場合は、正しい URL を使用していることを確認してください。たとえば、正しい形式は /v1alpha1/projects/PROJECT_ID/glossaries?filter=XXXX です。

  • ページトークンが無効です。

    • 用語集リストのページトークンが無効です。page_token フィールドの値は、前の list 用語集レスポンスから返された next_page_token フィールドの値と同じである必要があります。トークンが変更されているか、一部の文字が欠落している可能性があります。
    • gRPC を使用している場合は、page_token フィールドの値が、前のリスト レスポンスから返された next_page_token フィールドの値と同じかどうかを確認します。
    • HTTP を使用している場合は、URL の page_token フィールドの値が正しいかどうかを確認します。たとえば、正しい形式は /v1alpha1/projects/PROJECT_ID/glossaries?page_token=XXXX です。

  • CSV ファイル内の無効なデータ行。

    • 用語集入力ファイルに、不正なデータを含む行が 1 つ以上あります。
    • 用語集の入力ファイルを確認し、データが有効な形式を使用していることを確認します。

  • 言語コード {language code, column info} の列が重複しています。

    • 同じ言語コードを共有する列が少なくとも 2 つあります。
    • エラーの詳細を確認し、問題のある列を特定します。

  • CSV ファイルに有効な言語が不足しています。

    • 少なくとも 2 つの異なる言語の用語が必要です。
    • 用語集の入力ファイルには、少なくとも 2 つの異なる言語が必要です。

AITR2034 - JobInvalidArgument

エラー メッセージの例:

  • オペレーション名が無効です。

    • オペレーション名を確認します。
    • projects/PROJECT/operations/OPERATION_ID の形式で指定してください。

  • プロジェクト名が無効です。

    • プロジェクト名は projects/PROJECT_ID の形式にする必要があります。
    • HTTP URL は projects/YOUR_PROJECT_ID/glossaries 形式に従う必要があります。
    • gRPC を使用している場合は、リクエストの親フィールドをチェックして、正しい形式になっていることを確認します。
    • HTTP を使用している場合は、URL が /v1alpha1/projects/PROJECT_ID/glossaries の形式になっていることを確認してください。

  • ページトークンが無効です。

    • ListOperationRequest メソッド呼び出しで、list_token フィールドの値が数値であることを確認します。
    • gRPC を使用している場合は、page_token フィールドの値が前のリスト レスポンスの next_page_token フィールドの値と同じかどうかを確認します。
    • HTTP を使用している場合は、URL の page_token フィールドの値が正しいかどうかを確認します。たとえば、正しい形式は /v1alpha1/projects/PROJECT_ID/glossaries?page_token=XXXX です。

AITR2035 - DetectLanguageInvalidArgument

言語検出リクエストの引数が無効です。

エラー メッセージの例:

  • mime_type パラメータが無効です。

    • detectLanguage リクエストの mime_type パラメータが無効です。
    • text/plain または text/html の値を使用します。text/html 値がデフォルトです。

  • detectLanguage メソッド呼び出しの content フィールドが空です。

    • リクエストの content フィールドが空でないことを確認します。

AITR2053 - GlossaryNotFound

用語集リクエストの処理中にサーバーが見つかりませんでした。

エラー メッセージの例:

  • 用語集 {project_id: PROJECT_ID, glossary_id: GLOSSARY_ID} は存在しません。
    • 用語集: {project_id: PROJECT_ID, GLOSSARY_ID} は存在しません。
    • 指定されたプロジェクトに glossary_id を含む用語集が存在しません。用語集は、クエリを実行する前に作成する必要があります。
    • グロッサリーをクエリする前に、グロッサリーが作成されているかどうかを確認します。
    • gRPC を使用している場合は、リクエストの用語集フィールドをチェックして、正しいことを確認します。
    • GET HTTP を使用している場合は、正しい URL を使用していることを確認してください。たとえば、正しい形式は /v1alpha1/projects/PROJECT_ID/glossaries/GLOSSARY_ID です。

AITR2054 - JobNotFound

エラー メッセージの例:

  • ID のジョブが見つかりません。
    • 特定の async オペレーションが見つかりませんでした。
    • async オペレーションがデータベースに存在しない:
      • リクエストのオペレーション ID を確認します。
      • サポート スペシャリストにお問い合わせください。

AITR2060 - TranslationServiceAlreadyExists

一部のエンティティはすでに存在します。

  • リクエストを再試行します。
  • サポート スペシャリストにお問い合わせください。

AITR2063 - GlossaryAlreadyExists

用語集はすでに存在します。

エラー メッセージの例:

  • 同じソーステキストとターゲット テキストの用語集エントリがすでに存在します。

    • 用語集を使用して翻訳する場合、用語集の一部のエントリで同じソーステキストとターゲット テキストが共有されます。
    • Database Service の用語集に、同じソーステキストとターゲット テキストの重複するエントリがないことを確認します。

  • この名前の用語集はすでに存在します。

    • 同じ名前の用語集がすでに存在します。
    • 新しい用語集には別の名前を使用します。

AITR2090 - TranslationServiceFailedPrecondition

変換サービスがオペレーションに必要な状態になっていません。

エラー メッセージの例:

  • アライナー コンテキストの作成時に一致するファイルがない。
    • アライナー サービスは、Translation が実行するサービスの 1 つです。モデルファイルがないため、アライナー サービスを実行できませんでした。
    • サポート スペシャリストにお問い合わせください。

AITR2093 - GlossaryFailedPrecondition

Translation サービスが用語集を使用しようとしていますが、オペレーションが正常に機能するために必要な状態になっていません。

エラー メッセージの例:

  • 大きすぎる用語集エントリが見つかりました。
    • 用語集入力ファイルに、許可されている最大バイト数（max_bytes）を超えるサイズ（bytes）のエントリが含まれています。
    • 用語集の長さが max_bytes を超えないように更新します。

AITR2130 - TranslationServiceInternal

エラー メッセージの例:

  • データベース トランザクションを開始できませんでした。

    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • データベース トランザクションを終了できませんでした。

    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • コミットされていないデータベース トランザクションをロールバックできませんでした。

    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • テキストを翻訳できませんでした。

    • 入力文字数の上限（1,024 文字）を超えています。
    • 考慮事項の推奨事項に従います。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

AITR2133 - GlossaryInternal

エラー メッセージの例:

  • 用語集を取得できませんでした。

    • 接続の問題により、用語集をデータベースから取得できません。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • 削除する用語集のメタデータを解凍できません。

    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • 用語集の作成メタデータを解凍できません。

    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • 用語集の作成仕様を解凍できません。

    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • Translation サービスのデータベース トランザクションを作成できませんでした。

    • 用語集を保存するデータベースを作成できませんでした。
    • データベース サービスのステータスを確認し、Translation サーバーを再起動します。

  • Translation サービスのテーブルを作成できませんでした。

    • 用語集エントリを保存する変換テーブルを作成できませんでした。
    • データベース サービスのステータスを確認し、Translation サーバーを再起動します。

  • 用語集テーブルが存在しません。

    • Translation Glossary の必須テーブルが存在しません。
    • サーバーを再起動すると、テーブルの作成が再試行されます。

  • S3 サーバー証明書は空にできません。

    • StorageGrid に接続するために必要な情報が、翻訳サーバーに正しく入力されていません。
    • StorageGrid のステータスを確認し、Translation サーバーを再起動します。
    • サポート スペシャリストにお問い合わせください。

  • S3 アクセス ID は空にできません。

    • StorageGrid に接続するために必要な情報が、翻訳サーバーに正しく入力されていません。
    • StorageGrid のステータスを確認し、Translation サーバーを再起動します。
    • サポート スペシャリストにお問い合わせください。

  • S3 アクセス シークレットは空白にできません。

    • StorageGrid に接続するために必要な情報が、翻訳サーバーに正しく入力されていません。
    • StorageGrid のステータスを確認し、Translation サーバーを再起動します。
    • サポート スペシャリストにお問い合わせください。

AITR2134 - JobInternal

エラー メッセージの例:

  • 完了したジョブを更新できません。

  • ジョブを処理ステータスに設定できませんでした。

    • データベース トランザクションが失敗したため、ジョブレコードに対する読み取りまたは書き込みオペレーションが失敗しました。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • 完了したジョブを更新できません。

  • async オペレーションのクエリまたは実行に失敗しました。

    • 次のいずれかの理由により、async オペレーションをクエリまたは更新できません。
      • データベース接続に関する問題。
      • データが無効で、レスポンスへの解析に失敗しました。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • ジョブの読み取りに失敗しました。

    • データベース トランザクションの失敗により、ジョブレコードに対する読み取りまたは書き込みオペレーションが失敗しました。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • データベースからジョブを削除できませんでした。

    • データベース トランザクションの失敗により、ジョブレコードに対する読み取りまたは書き込みオペレーションが失敗しました。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

  • 同じ job_id を持つジョブが複数返される。

    • データベースをチェックして、各 job_id が 1 回だけ表示されることを確認します。
    • サポート スペシャリストにお問い合わせください。

AITR2135 - DetectLanguageInternal

エラー メッセージの例:

  • 言語検出の結果がありません。
    • 言語検出ツールで入力コンテンツの言語を特定できない。
    • リクエストの内容を確認し、文字が有効で、単語が混在した言語になっていないことを確認します。
    • リクエストを再試行します。
    • サポート スペシャリストにお問い合わせください。

AITR2140 - TranslationServiceUnavailable

翻訳サービスを利用できません。