- Categorias:
VALIDATE¶
Valida os arquivos carregados em uma execução passada do comando COPY INTO <tabela> e retorna todos os erros encontrados durante o carregamento, em vez de retornar apenas o primeiro erro.
Sintaxe¶
VALIDATE( [<namespace>.]<table_name> , JOB_ID => { '<query_id>' | '_last' } )
Argumentos¶
[namespace.]table_name
Especifica o nome totalmente qualificado da tabela que era o destino do carregamento.
O namespace é o banco de dados e/ou esquema no qual a tabela reside, na forma de
database_name.schema_name
ouschema_name
. É opcional se um banco de dados e um esquema estiverem em uso atualmente dentro da sessão do usuário; caso contrário, ele é obrigatório.JOB_ID => query_id | _last
A ID do o comando COPY INTO <tabela> a ser validado:
A ID pode ser obtida na coluna Query ID na página History
em Classic Console. A ID da consulta especificada deve ter sido para a tabela de destino especificada.
Se
_last
for especificado em vez dequery_id
, a função valida o último carregamento executado durante a sessão atual, independentemente da tabela de destino especificada.
Notas de uso¶
A validação não retorna resultados para instruções COPY que especificam
ON_ERROR = ABORT_STATEMENT
(valor padrão).A validação falha se:
Instruções SELECT usadas para transformar dados durante uma operação COPY INTO <tabela>.
O usuário atual não tiver acesso ao
table_name
.O usuário atual não for o usuário que executou
query_id
e não tiver privilégios de controle de acesso sobre este usuário.
Se novos arquivos foram adicionados ao estágio utilizado por
query_id
desde que o carregamento for executado, os novos arquivos adicionados são ignorados durante a validação.Se os arquivos foram removidos do estágio utilizado por
query_id
desde que o carregamento foi executado, os arquivos removidos são reportados como desaparecidos.
Exemplos¶
Retornar erros para o último comando COPY executado:
SELECT * FROM TABLE(VALIDATE(t1, JOB_ID => '_last'));
Retornar erros especificando uma ID de consulta obtida da página Query History na Snowsight ou da página History na Classic Console:
SELECT * FROM TABLE(VALIDATE(t1, JOB_ID=>'5415fa1e-59c9-4dda-b652-533de02fdcf1'));
A mesma consulta acima, mas salvando os resultados em uma tabela para referência futura:
CREATE OR REPLACE TABLE save_copy_errors AS SELECT * FROM TABLE(VALIDATE(t1, JOB_ID=>'5415fa1e-59c9-4dda-b652-533de02fdcf1'));