O Google usa tecnologia de IA na tradução de conteúdos para seu idioma de preferência. As traduções com IA podem ter erros.

Migrar código com o tradutor de SQL em lote

Neste documento, descrevemos como usar o tradutor de SQL em lote no BigQuery para traduzir scripts escritos em outros dialetos de SQL em consultas do GoogleSQL. Este documento destina-se a usuários que estão familiarizados com o Google Cloud console.

Para uma lista de dialetos SQL compatíveis com esse tradutor, consulte Dialetos SQL compatíveis.

Para conferir uma lista de locais de processamento compatíveis, consulte Locais.

Antes de começar

Antes de enviar um job de tradução, siga estas etapas.

Ativar traduções de SQL

Habilite a API necessária e obtenha as permissões necessárias para usar um tradutor SQL do BigQuery. Para obter mais informações, consulte Habilitar traduções SQL.

Permissões necessárias

Para receber as permissões necessárias para criar jobs de tradução com o tradutor interativo, a API Translation ou o tradutor de SQL em lote, peça ao administrador para conceder a você os seguintes papéis do IAM no recurso parent:

Visualizar e monitorar jobs de migração: Leitor do MigrationWorkflow (roles/bigquerymigration.viewer)
Envio de jobs de migração: Editor do MigrationWorkflow (roles/bigquerymigration.editor)
Acesse os buckets do Cloud Storage para entrada e arquivos: Administração de objetos de armazenamento (roles/storage.objectAdmin) - no bucket de origem e destino do Cloud Storage.

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esses papéis predefinidos contêm as permissões necessárias para criar jobs de tradução com o tradutor interativo, a API Translation ou o tradutor de SQL em lote. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para criar jobs de tradução com o tradutor interativo, a API Translation ou o tradutor de SQL em lote:

bigquerymigration.workflows.create
bigquerymigration.workflows.get
bigquerymigration.workflows.list
bigquerymigration.workflows.delete
bigquerymigration.subtasks.get
bigquerymigration.subtasks.list
storage.objects.get
storage.objects.list
storage.objects.create

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Coletar arquivos de origem

Os arquivos de origem precisam ser arquivos de texto com SQL válido para o dialeto de origem. Os arquivos de origem também podem incluir comentários. Faça o possível para garantir que o SQL seja válido usando os métodos disponíveis.

Criar arquivos de metadados

Para ajudar o serviço a gerar resultados de tradução mais precisos, recomendamos que você forneça arquivos de metadados. No entanto, isso não é obrigatório.

Use a ferramenta de extração de linha de comando dwh-migration-dumper para gerar as informações de metadados ou forneça seus próprios arquivos de metadados. Depois que os arquivos de metadados forem preparados, será possível incluí-los com os arquivos de origem na pasta de origem da tradução. O tradutor os detecta automaticamente e os aproveita para traduzir arquivos de origem. Não é necessário definir configurações extras para isso.

Para gerar informações de metadados usando a ferramenta dwh-migration-dumper, consulte Gerar metadados para tradução.

Para fornecer seus próprios metadados, colete as instruções de linguagem de definição de dados (DDL) dos objetos SQL do sistema de origem em arquivos de texto separados.

Decidir como enviar o trabalho de tradução

Você tem três opções para enviar um job de tradução em lote:

Cliente da tradução em lote: para definir um job, altere as configurações em um arquivo de configuração e envie o job usando a linha de comando. Essa abordagem não exige o upload manual dos arquivos de origem para o Cloud Storage. O cliente ainda usa o Cloud Storage para armazenar arquivos durante o processamento do job de tradução.

O cliente de tradução em lote legado é um cliente Python de código aberto que permite traduzir arquivos de origem localizados em sua máquina local e ter os arquivos traduzidos como saída em um diretório local. Defina o cliente para uso básico alterando algumas configurações no arquivo de configuração. Se quiser, também é possível configurar o cliente para realizar tarefas mais complexas, como substituição de macros e pré e pós-processamento de entradas e saídas de tradução. Para mais informações, consulte o readme do cliente de tradução em lote.
Console doGoogle Cloud : configure e envie um job usando uma interface de usuário. Essa abordagem exige que você faça upload de arquivos de origem para o Cloud Storage.

Criar arquivos YAML de configuração

Também é possível criar e usar arquivos YAML de configuração para personalizar as traduções em lote. Esses arquivos podem ser usados para transformar a saída da tradução de várias maneiras. Por exemplo, é possível criar um arquivo YAML de configuração para alterar o caso de um objeto SQL durante a conversão.

Se você quiser usar o console Google Cloud ou a API BigQuery Migration para um job de tradução em lote, faça upload do arquivo YAML de configuração para o bucket do Cloud Storage que contém os arquivos de origem.

Se você quiser usar o cliente de tradução em lote, coloque o arquivo YAML de configuração na pasta de entrada da tradução local.

Fazer upload de arquivos de entrada no Cloud Storage

Se você quiser usar o console do Google Cloud ou a API BigQuery Migration para executar um job de tradução, faça upload dos arquivos de origem que contêm as consultas e os scripts que você quer traduzir para o Cloud Storage. Também é possível fazer upload de qualquer arquivo de metadados ou arquivos YAML de configuração para o mesmo bucket do Cloud Storage e diretório que contém os arquivos de origem. Para mais informações sobre como criar buckets e fazer upload de arquivos para o Cloud Storage, consulte Criar buckets e Fazer upload de objetos de um sistema de arquivos.

Como processar funções SQL sem suporte com UDFs auxiliares

Ao traduzir SQL de um dialeto de origem para o BigQuery, algumas funções podem não ter um equivalente direto. Para resolver isso, o serviço de migração do BigQuery (e a comunidade mais ampla do BigQuery) oferece funções definidas pelo usuário (UDFs) auxiliares que replicam o comportamento dessas funções de dialeto de origem sem suporte.

Essas UDFs geralmente são encontradas no conjunto de dados público bqutil, permitindo que as consultas traduzidas se refiram a elas inicialmente usando o formato bqutil.<dataset>.<function>(). Por exemplo, bqutil.fn.cw_count().

Considerações importantes para ambientes de produção:

Embora o bqutil ofereça acesso conveniente a essas UDFs auxiliares para tradução e testes iniciais, não é recomendável depender diretamente do bqutil para cargas de trabalho de produção por vários motivos:

Controle de versão: o projeto bqutil hospeda a versão mais recente dessas UDFs, o que significa que as definições podem mudar com o tempo. Depender diretamente de bqutil pode levar a um comportamento inesperado ou a mudanças significativas nas suas consultas de produção se a lógica de uma UDF for atualizada.
Isolamento de dependências: a implantação de UDFs no seu próprio projeto isola o ambiente de produção de mudanças externas.
Personalização: talvez seja necessário modificar ou otimizar essas UDFs para se adequar melhor à sua lógica de negócios ou requisitos de performance específicos. Isso só é possível se eles estiverem dentro do seu próprio projeto.
Segurança e governança: as políticas de segurança da sua organização podem restringir o acesso direto a conjuntos de dados públicos, como o bqutil, para o processamento de dados de produção. Copiar UDFs para seu ambiente controlado está de acordo com essas políticas.

Implantando UDFs auxiliares em seu projeto:

Para uma utilização em produção confiável e estável, você deve implantar essas UDFs auxiliares em seu próprio projeto e conjunto de dados. Assim, você tem controle total sobre a versão, a personalização e o acesso. Para instruções detalhadas sobre como implantar essas UDFs, consulte o guia de implantação de UDFs no GitHub. Este guia fornece os scripts e as etapas necessárias para copiar as UDFs para seu ambiente.

Enviar um job de tradução

Siga estas etapas para iniciar um job de tradução, ver o progresso dele e ver os resultados.

Console

Para seguir essas etapas, é necessário ter feito upload dos arquivos de origem em um bucket do Cloud Storage.

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
No Tradução SQL painel, clique Iniciar tradução.
Em Configuração de tradução, insira o seguinte:
1. Em Nome de exibição, digite um nome para o job de tradução. O nome pode conter letras, números ou sublinhados.
2. Em local de processamento, selecione o local em que você quer que o trabalho de tradução seja executado. Por exemplo, se você estiver na Europa e não quiser que seus dados cruzem os limites de local, selecione a região eu. O job de tradução tem um desempenho melhor quando você escolhe o mesmo local que seu bucket de arquivo de origem.
3. Em Dialeto de origem, selecione o dialeto SQL que você quer traduzir.
4. Para Dialeto de destino, selecione GoogleSQL.
Clique em Próxima.
Em Detalhes do local do arquivo, especifique os caminhos do Cloud Storage a serem usados para entrada e saída da tradução. É possível digitar os caminhos no formato bucket_name/folder_name/ ou usar a opção Procurar para navegar até uma pasta.
1. Para Local do diretório de saída, especifique um caminho para a pasta de destino do Cloud Storage para os arquivos traduzidos. Ele serve como um diretório raiz para toda a saída de tradução.
2. Escolha um ou mais Locais do diretório de entrada que contenham o caminho para os arquivos SQL a serem traduzidos.
3. Cada diretório de entrada pode opcionalmente receber um nome de subdiretório de saída abaixo do diretório raiz de saída, se necessário.
Clique em Próxima.
Selecione as configurações opcionais necessárias para personalizar os metadados e quaisquer saídas de tradução adicionais.
Você pode personalizar ainda mais o comportamento da tradução criando arquivos YAML de configuração e colocando esses arquivos no bucket de entrada do Cloud Storage. Esses arquivos podem ser usados para definir objetos de renomeação, ativar otimizações, melhorar traduções com o Gemini e muito mais. Para mais informações sobre arquivos YAML de configuração, consulte Criar um arquivo YAML de configuração.
Clique em Criar para iniciar o job de tradução.

Depois que o job de tradução for criado, será possível ver o status na lista de jobs de tradução.

Cliente de tradução em lote

Instale o cliente de tradução em lote e a Google Cloud CLI.
Gere um arquivo de credenciais da CLI gcloud.
No diretório de instalação do cliente de tradução em lote, use o editor de texto de sua preferência para abrir o arquivo config.yaml e modificar as seguintes configurações:
- project_number: digite o número do projeto que você quer usar para o job de tradução em lote. É possível encontrar essa informação no painel Informações do projeto na página de boas-vindas do console doGoogle Cloud do projeto.
- gcs_bucket: digite o nome do bucket do Cloud Storage que o cliente de tradução em lote usa para armazenar arquivos durante o processamento do job de tradução.
- input_directory: Digite o caminho absoluto ou relativo para o diretório que contém os arquivos de origem e quaisquer arquivos de metadados.
- output_directory: digite o caminho absoluto ou relativo para o diretório de destino dos arquivos traduzidos.
Salve as alterações e feche o arquivo config.yaml.
Coloque os arquivos de origem e de metadados no diretório de entrada.
Execute o cliente de tradução em lote usando o seguinte comando:
```
bin/dwh-migration-client
```
Crie um job de tradução.
- O exemplo a seguir mostra um comando para criar uma tarefa de tradução. O comando vai executar o fluxo de trabalho e mostrar a saída se ele for bem-sucedido.
```
gcloud bq migration-workflows create --location=us --config-file=CONFIG_FILE_NAME.json
```
- O exemplo a seguir mostra um comando para criar e executar o fluxo de trabalho com a flag --async. O comando vai criar e executar o fluxo de trabalho e retornar imediatamente com um link para ele.
```
gcloud bq migration-workflows create --location=LOCATION  --config-file=CONFIG_FILE_NAME.json --async
```
- O exemplo a seguir mostra um comando para listar seus jobs de tradução:
```
gcloud bq migration-workflows list --location=LOCATION
```
Substitua:
- LOCATION: o local do Google Cloud projeto que está executando esse job de tradução.
- CONFIG_FILE_NAME: o nome do arquivo config.yaml. Assim que a tarefa de tradução for criada, você poderá ver o status dela na lista de tarefas de tradução. Google Cloud console.
Opcional. Depois que o job de tradução for concluído, exclua os arquivos criados no bucket do Cloud Storage especificado para evitar custos de armazenamento.

CLI do BigQuery

Você pode executar o tradutor de SQL em lote usando a ferramenta de linha de comando bq com estas etapas:

Crie um arquivo de configuração de tradução em YAML ou JSON. Nesse arquivo, você precisa definir o caminho para o arquivo de origem, o destino da saída e os dialetos de origem e de destino da tradução.

O exemplo a seguir mostra um arquivo YAML de configuração de tradução do Teradata para o BigQuery:

tasks:
translation_task:
  type: Teradata2BigQuery_Translation
  translationDetails:
    sourceTargetMapping:
    - sourceSpec:
        baseUri: gs://bq-translations/input
      targetSpec:
        relativePath: output
    targetBaseUri: gs://bq-translations
    targetTypes:
    - sql
    sourceEnvironment:
      defaultDatabase: default_db
      schemaSearchPath:
      - foo

O exemplo a seguir mostra um arquivo JSON de configuração de tradução para uma tradução de Teradata para BigQuery:

{
"tasks": {
  "translation_task": {
    "type": "Teradata2BigQuery_Translation",
    "translationDetails": {
      "sourceTargetMapping": [
        {
          "sourceSpec": {
            "literal": {
              "literalString": "sel 1",
              "relativePath": "my_input_1"
            },
            "encoding": "UTF-8"
          }
        },
        {
          "sourceSpec": {
            "literal": {
              "literalString": "sel 2",
              "relativePath": "my_input_2"
            },
            "encoding": "UTF-8"
          }
        }
      ],
      "targetReturnLiterals": [
        "sql/my_input_1",
        "sql/my_input_2"
      ]
    }
  }
}
}

Depois que a configuração de tradução for criada, execute o comando a seguir para executar o job de tradução.
```
bq mk --migration_workflow --location=LOCATION --config_file=CONFIG_FILE_NAME.json
```
Substitua:
- LOCATION: a localização do Google Cloud projeto que está executando esta tarefa de tradução.
- CONFIG_FILE_NAME: o nome do arquivo config.yaml.

Para visualizar detalhes sobre uma tarefa de tradução específica, execute o seguinte comando:
```
bq show --migration_workflow projects/PROJECT_ID/ locations/us/workflows/WORKFLOW_ID
```
Substitua:
- PROJECT_ID: o ID do Google Cloud projeto que está executando esta tarefa de tradução.
- WORKFLOW_ID: o ID da tarefa de tradução.

Para visualizar os resultados de uma tradução específica, execute o seguinte comando:

gcloud bq migration-workflows describe projects/PROJECT_ID    /locations/us/workflows/WORKFLOW_ID

Para remover uma tarefa de tradução da lista, execute o seguinte comando:

bq rm --migration_workflow projects/PROJECT_ID/locations/us/workflows/WORKFLOW_ID

Para listar todos os seus jobs de tradução, execute o seguinte comando:
```
bq ls --migration_workflow --location=LOCATION
```

Explorar o resultado da tradução

Após executar a tarefa de tradução, você poderá visualizar informações sobre a tarefa em Google Cloud console. Se você usou o console Google Cloud para executar o trabalho, poderá ver os resultados do trabalho no bucket do Cloud Storage de destino que você especificou. Se você usou o cliente de tradução em lote para executar o job, será possível ver os resultados do job no diretório de saída especificado. O tradutor SQL em lote gera os seguintes arquivos para o destino especificado:

Os arquivos traduzidos.
O relatório de resumo da tradução no formato CSV.
O mapeamento do nome de saída consumido no formato JSON.
Os arquivos de sugestão da IA.

Saída do consoleGoogle Cloud

Para ver detalhes do job de tradução, siga estas etapas:

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
Na lista de jobs de tradução, localize aquele para o qual você quer ver os detalhes de tradução. Em seguida, clique no nome do job de tradução. Você pode ver uma visualização em diagrama de Sankey que ilustra a qualidade geral do trabalho, o número de linhas de código de entrada (excluindo linhas em branco e comentários) e uma lista de problemas que ocorreram durante o processo de tradução. Você deve priorizar as correções da esquerda para a direita. Problemas em um estágio inicial podem causar problemas adicionais em estágios subsequentes.
Mantenha o ponteiro sobre as barras de erro ou aviso e analise as sugestões para determinar as próximas etapas de depuração do job de tradução.
Selecione a guia Resumo do registro para ver um resumo dos problemas de tradução, incluindo as categorias de problemas, as ações sugeridas e a frequência com que cada problema ocorreu. Clique nas barras de visualização de Sankey para filtrar problemas. Você também pode selecionar uma categoria de problema para ver as mensagens de registro associadas a ela.
Selecione a guia Log Messages para ver mais detalhes sobre cada problema de tradução, incluindo a categoria dele, a mensagem específica e um link para o arquivo em que o problema ocorreu. Clique nas barras de visualização de Sankey para filtrar problemas. Você pode selecionar um problema na guia Mensagem de registro para abrir a guia Código que exibe o arquivo de entrada e saída, se aplicável.
Clique na guia Detalhes do job para ver os detalhes da configuração do job.

Relatório do resumo

O relatório de resumo é um arquivo CSV que contém uma tabela de todas as mensagens de aviso e erro encontradas durante o job de tradução.

Para ver o arquivo de resumo no Google Cloud console, siga estas etapas:

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
Na lista de jobs de tradução, localize o job que você quer e clique no nome dele ou em Mais opções > Mostrar detalhes.
Na guia Detalhes do job, na seção Relatório de tradução, clique em translation_report.csv.
Na página Detalhes do objeto, clique no valor na linha URL autenticado para ver o arquivo no navegador.

A tabela a seguir descreve as colunas do arquivo de resumo:

Coluna	Descrição
Carimbo de data/hora	O carimbo de data/hora em que o problema ocorreu.
FilePath	O caminho para o arquivo de origem ao qual o problema está associado.
FileName	O nome do arquivo de origem ao qual o problema está associado.
ScriptLine	O número da linha em que o problema ocorreu.
ScriptColumn	O número da coluna em que o problema ocorreu
TranspilerComponent	O componente interno do mecanismo de tradução em que ocorreu o aviso ou o erro. Essa coluna pode estar vazia.
Ambiente	Ambiente de dialeto de tradução associado ao aviso ou erro. Essa coluna pode estar vazia.
ObjectName	O objeto SQL no arquivo de origem associado ao aviso ou erro. Essa coluna pode estar vazia.
Gravidade	A gravidade do problema, seja de aviso ou erro.
Categoria	É a categoria do problema de tradução.
SourceType	A origem do problema. O valor nesta coluna pode ser `SQL`, indicando um problema nos arquivos SQL de entrada, ou `METADATA`, indicando um problema no pacote de metadados.
Mensagem	O aviso ou a mensagem de erro do problema de tradução.
ScriptContext	O snippet SQL no arquivo de origem associado ao problema.
Ação	A ação recomendada para resolver o problema.

Guia "Código"

A guia de código permite revisar mais informações sobre os arquivos de entrada e saída de um job de tradução específico. Na guia de código, é possível examinar os arquivos usados em um job de tradução, analisar uma comparação lado a lado de um arquivo de entrada e a tradução dele em busca de imprecisões e ver mensagens e resumos de registro. para um arquivo específico em um job.

Para acessar a guia "Código", siga estas etapas:

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
Na lista de jobs de tradução, localize o job que você quer e clique no nome dele ou em Mais opções > Mostrar detalhes.
Selecione a guia "Código". A guia "Código" consiste nos seguintes painéis:
- Explorador de arquivos: contém todos os arquivos SQL usados para tradução. Clique em um arquivo para ver a entrada e a saída da tradução, além de problemas de tradução do processo.
- Entrada aprimorada com o Gemini: o SQL de entrada que foi traduzido pelo mecanismo de tradução. Se você especificou regras de personalização do Gemini para o SQL de origem na configuração do Gemini, o tradutor transforma primeiro a entrada original e depois traduz a entrada aprimorada pelo Gemini. Para conferir a entrada original, clique em Ver entrada original.
- Saída da tradução: o resultado da tradução. Se você especificou regras de personalização do Gemini para o SQL de destino em a configuração do Gemini, a transformação será aplicada ao resultado traduzido como uma saída aprimorada pelo Gemini. Se uma saída aprimorada pelo Gemini estiver disponível, clique no botão Sugestão do Gemini para analisar a saída.
Opcional: para ver um arquivo de entrada e um de saída no tradutor de SQL interativo do BigQuery, clique em Editar. É possível editar os arquivos e salvar o arquivo de saída de volta no Cloud Storage.

Guia "Configuração"

Você pode adicionar, renomear, visualizar ou editar os arquivos YAML de configuração na guia Configuração.O Explorador de esquemas mostra a documentação dos tipos de configuração compatíveis para ajudar você a escrever os arquivos YAML de configuração. Após editar os arquivos YAML de configuração, você pode executar a tarefa novamente para usar a nova configuração.

Para acessar a guia "Configuração", siga estas etapas:

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
Na lista de jobs de tradução, localize o job que você quer e clique no nome dele ou em Mais opções > Mostrar detalhes.
Na janela Detalhes da tradução, clique na guia Configuração.

Acesse a guia "Configuração" na página de tradução de SQL.

Para adicionar um novo arquivo de configuração:

Clique em more_vert Mais opções > Criar arquivo YAML de configuração.
Um painel vai aparecer para que você escolha o tipo, o local e o nome do novo arquivo YAML de configuração.
Clique em Criar.

Para editar um arquivo de configuração:

Clique no arquivo YAML de configuração.
Edite o arquivo e clique em Salvar.
Clique em Executar novamente para executar um novo job de tradução que usa os arquivos YAML de configuração editados.

Para renomear um arquivo de configuração, clique em more_vert Mais opções > Renomear.

Arquivo de mapeamento de nome de saída consumido

Esse arquivo JSON contém as regras de mapeamento do nome de saída que foram usadas pelo job de tradução. As regras nesse arquivo podem ser diferentes das regras de mapeamento de nome de saída especificadas para o job de tradução devido a conflitos nas regras de mapeamento de nome ou falta de regras de mapeamento de nome para objetos SQL que foram identificados durante a tradução. Revise esse arquivo para determinar se as regras de mapeamento de nome precisam de correção. Se isso acontecer, crie novas regras de mapeamento de nome de saída para resolver os problemas identificados e execute um novo job de tradução.

Arquivos traduzidos

Para cada arquivo de origem, um arquivo de saída correspondente é gerado no caminho de destino. O arquivo de saída contém a consulta traduzida.

Depurar consultas SQL traduzidas em lote com o tradutor de SQL interativo

Use o tradutor de SQL interativo do BigQuery para analisar ou depurar uma consulta SQL usando os mesmos metadados ou informações de mapeamento de objetos do banco de dados de origem. Depois de concluir um job de tradução em lote, o BigQuery gera um ID de configuração de tradução com informações sobre os metadados do job, o mapeamento de objetos ou o caminho de pesquisa do esquema, conforme aplicável para a consulta. Use o ID de configuração da tradução em lote com o tradutor de SQL interativo para executar consultas SQL com a configuração especificada.

Para iniciar uma tradução de SQL interativa usando um ID de configuração de tradução em lote, siga estas etapas:

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
Na lista de jobs de tradução, localize o job que você quer e clique em Mais opções > Abrir tradução interativa.

O tradutor de SQL interativo do BigQuery agora é aberto com o ID de configuração da tradução em lote correspondente. Para consultar o ID de configuração da tradução interativa, clique em Ferramentas > Tradução de consultas > Configurações de tradução no tradutor de SQL interativo.

Para depurar um arquivo de tradução em lote no tradutor de SQL interativo, siga estas etapas:

No console Google Cloud , acesse a página Tradução de SQL.

Acessar a conversão de SQL
Na lista de jobs de tradução, localize o job que você quer e clique no nome dele ou em Mais opções > Mostrar detalhes.
Na janela Detalhes da tradução, clique na guia Código.
No explorador de arquivos, clique no nome do arquivo para abri-lo.
Ao lado do nome do arquivo de saída, clique em Editar para abrir os arquivos no conversor de SQL interativo (Prévia).

Os arquivos de entrada e saída são preenchidos no tradutor de SQL interativo, que agora usa o ID de configuração da tradução em lote correspondente.
Para salvar o arquivo de saída editado de volta no Cloud Storage, no tradutor interativo de SQL, clique em Salvar > Salvar no GCS.

Limitações

O tradutor não pode traduzir funções definidas pelo usuário (UDFs) de linguagens que não sejam SQL, porque não é possível analisá-las para determinar os tipos de dados de entrada e saída. Isso faz com que a conversão de instruções SQL que façam referência a essas UDFs seja imprecisa. Para garantir que as UDFs não SQL sejam referenciadas corretamente durante a conversão, use SQL válido para criar UDFs de marcador com as mesmas assinaturas.

Por exemplo, digamos que você tenha uma UDF escrita em C que calcula a soma de dois inteiros. Para garantir que as instruções SQL que se referem a essa UDF sejam traduzidas corretamente, crie uma UDF em SQL com marcador que compartilhe a mesma assinatura da UDF em C, conforme mostrado no exemplo a seguir:

CREATE FUNCTION Test.MySum (a INT, b INT)
  RETURNS INT
  LANGUAGE SQL
  RETURN a + b;

Salve essa UDF de marcador em um arquivo de texto e inclua-o como um dos arquivos de origem do job de tradução. Isso permite que o tradutor aprenda a definição de UDF e identifique os tipos de dados de entrada e saída esperados.

Cotas e limites

Aplicam-se as cotas da API BigQuery Migration.
Cada projeto pode ter no máximo 10 tarefas de tradução ativas.
Não há um limite rígido para o número total de arquivos de origem e de metadados, mas recomendamos manter o número de arquivos abaixo de 1.000 para melhor desempenho.

Resolver erros de tradução

Problemas de tradução do `RelationNotFound` ou `AttributeNotFound`

Após traduzir uma consulta usando o tradutor SQL em lote , você pode encontrar uma tradução com falha com o erro RelationNotFound ou AttributeNotFound.

Para encontrar traduções com falha, acesse a página Detalhes da tradução e abra a guia Mensagens de registro.

A tradução funciona melhor com DDLs de metadados. Quando as definições de objetos SQL não são encontradas, o mecanismo de tradução gera problemas RelationNotFound ou AttributeNotFound. Recomendamos o uso do extrator de metadados para gerar pacotes de metadados e garantir que todas as definições de objetos estejam presentes. Adicionar metadados é a primeira etapa recomendada para resolver a maioria dos erros de tradução, já que geralmente pode corrigir muitos outros erros causados indiretamente pela falta de metadados.

Para mais informações, consulte Gerar metadados para tradução e avaliação.

Corrigir problemas de tradução com o Gemini

Para corrigir trabalhos de tradução com falha que apresentem os erros RelationNotFound ou AttributeNotFound, você também pode usar o Gemini para tentar resolver esses problemas seguindo os passos abaixo.

Navegue até a página Detalhes da tradução e abra a guia Mensagens de registro.
Clique na consulta que tem a mensagem RelationNotFound ou AttributeNotFound na coluna Categoria.
Clique na mensagem de erro para navegar até o arquivo e a linha que contém o erro na aba de código.
Na coluna Ação, clique em Correção sugerida.
Selecione uma das seguintes opções: Aplicar ou Aplicar e executar novamente:
- Clique em Aplicar para copiar o arquivo de esquema gerado do diretório de saída para o de entrada.
- Clique em Aplicar e executar novamente para copiar o arquivo de esquema gerado do diretório de saída para o diretório de entrada e abrir uma janela de nova execução.

Preços

Não há cobrança para usar o conversor de SQL em lote. No entanto, o armazenamento usado para armazenar arquivos de entrada e saída incorre em taxas normais. Para mais informações, consulte preços de armazenamento.

A seguir

Saiba mais sobre as seguintes etapas na migração de um data warehouse:

Migrar código com o tradutor de SQL em lote

Antes de começar

Ativar traduções de SQL

Permissões necessárias

Permissões necessárias

Coletar arquivos de origem

Criar arquivos de metadados

Decidir como enviar o trabalho de tradução

Criar arquivos YAML de configuração

Fazer upload de arquivos de entrada no Cloud Storage

Como processar funções SQL sem suporte com UDFs auxiliares

Considerações importantes para ambientes de produção:

Implantando UDFs auxiliares em seu projeto:

Enviar um job de tradução

Console

Cliente de tradução em lote

CLI do BigQuery

Explorar o resultado da tradução

Saída do consoleGoogle Cloud

Relatório do resumo

Guia "Código"

Guia "Configuração"

Arquivo de mapeamento de nome de saída consumido

Arquivos traduzidos

Depurar consultas SQL traduzidas em lote com o tradutor de SQL interativo

Limitações

Cotas e limites

Resolver erros de tradução

Problemas de tradução do RelationNotFound ou AttributeNotFound

Corrigir problemas de tradução com o Gemini

Preços

A seguir

Problemas de tradução do `RelationNotFound` ou `AttributeNotFound`