COPY JOB (pré-visualização) - Amazon Redshift
Permissão obrigatóriaSintaxeParâmetrosObservações de usoExemplos

COPY JOB (pré-visualização)

Esta é uma documentação de pré-lançamento para cópia automática (SQL COPY JOB), que está em versão de pré-visualização. A documentação e o atributo estão sujeitos a alterações. Recomendamos o uso desse atributo somente em ambientes de teste, e não em ambientes de produção. A prévia pública terminará em 31 de outubro de 2024. Os clusters de pré-visualização serão removidos automaticamente duas semanas após o final da prévia. Para conferir os termos e condições da pré-visualização, consulte Betas e pré-visualizações nos Termos de serviços da AWS.

Para obter mais informações sobre como usar este comando em pré-visualização, consulte Carregar tabelas com ingestão contínua de arquivos do Amazon S3 (visualização prévia).

Gerencia comandos COPY que carregam dados em uma tabela. O comando COPY JOB é uma extensão do comando COPY e automatiza o carregamento de dados dos buckets do Amazon S3. Quando você cria um trabalho COPY, o Amazon Redshift detecta quando são criados arquivos do Amazon S3 em um caminho especificado e os carrega automaticamente sem sua intervenção. Os mesmos parâmetros usados no comando COPY original são usados ao carregar os dados. O Amazon Redshift monitora os arquivos carregados para verificar se eles são carregados apenas uma vez.

nota

Para obter informações sobre o comando COPY, incluindo uso, parâmetros e permissões, consulteCOPY.

Permissão obrigatória

Para executar o comando COPY de um COPY JOB, você deve ter o privilégio INSERT da tabela que está sendo carregada.

O perfil do IAM especificado com o comando COPY deve ter permissão para acessar os dados a serem carregados. Para ter mais informações, consulte Permissões do IAM para COPY, UNLOAD e CREATE LIBRARY.

Sintaxe

Crie um trabalho de cópia. Os parâmetros do comando COPY são salvos com o trabalho de cópia.

COPY copy-command JOB CREATE job-name
[AUTO ON | OFF]

Altere a configuração de um trabalho de cópia.

COPY JOB ALTER job-name
[AUTO ON | OFF]

Execute um trabalho de cópia. Os parâmetros do comando COPY armazenados são usados.

COPY JOB RUN job-name

Liste todos os trabalhos de cópia.

COPY JOB LIST

Mostre os detalhes de um trabalho de cópia.

COPY JOB SHOW job-name

Exclua um trabalho de cópia.

COPY JOB DROP job-name

Parâmetros

copy-command

Um comando COPY que carrega dados do Amazon S3 para o Amazon Redshift. A cláusula contém parâmetros de COPY que definem o bucket do Amazon S3, a tabela de destino, o perfil do IAM e outros parâmetros usados ao carregar dados. Todos os parâmetros do comando COPY para um carregamento de dados do Amazon S3 são compatíveis, exceto:

  • COPY JOB não ingere arquivos preexistentes na pasta apontada pelo comando COPY. Somente arquivos criados após o carimbo de data e hora da criação de COPY JOB são ingeridos.

  • Não é possível especificar um comando COPY com as opções MAXERROR ou IGNOREALLERRORS.

  • Você não pode especificar um arquivo de manifesto. COPY JOB exige um local designado no Amazon S3 para monitorar a criação de arquivos.

  • Você não pode especificar um comando COPY com tipos de autorização como chaves de acesso e secretas. Somente comandos COPY que usam o parâmetro IAM_ROLE para autorização são compatíveis. Para ter mais informações, consulte Parâmetros de autorização.

  • O COPY JOB não oferece suporte ao perfil do IAM padrão associado com o cluster. Você deve especificar o IAM_ROLE no comando COPY.

Para ter mais informações, consulte COPY do Amazon S3.

job-name

O nome do trabalho usado para fazer referência ao trabalho COPY.

[AUTO ON | OFF]

Cláusula que indica se os dados do Amazon S3 são carregados automaticamente nas tabelas do Amazon Redshift.

  • Quando ON, o Amazon Redshift monitora o caminho de origem do Amazon S3 para arquivos recém-criados e, se encontrado, um comando COPY é executado com os parâmetros de COPY na definição do trabalho. Esse é o padrão.

  • Quando OFF, o Amazon Redshift não executa COPY JOB automaticamente.

Observações de uso

As opções do comando COPY não são validadas até o tempo de execução. Por exemplo, um IAM_ROLE inválido ou uma fonte de dados do Amazon S3 resulta em erros de tempo de execução quando COPY JOB é iniciado.

Se o cluster estiver pausado, COPY JOBS não serão executados.

Para consultar arquivos de comando COPY carregados e erros de carregamento, consulte STL_LOAD_COMMITS, STL_LOAD_ERRORS e STL_LOADERROR_DETAIL. Para ter mais informações, consulte Como verificar se os dados foram carregados corretamente.

Exemplos

O exemplo a seguir mostra a criação de um COPY JOB para carregar dados de um bucket do Amazon S3. 

COPY public.target_table
FROM 's3://amzn-s3-demo-bucket/staging-folder'
IAM_ROLE 'arn:aws:iam::123456789012:role/MyLoadRoleName' 
JOB CREATE my_copy_job_name
AUTO ON;