VALIDATE¶

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 ou schema_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 web interface. A ID da consulta especificada deve ter sido para a tabela de destino especificada.

• Se _last for especificado em vez de query_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 consulta de obtida da página Query History no Snowsight ou da página History na interface da web clássica:

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'));