Comando DUPLICATES

Detecta quando valores duplicados ou registros inteiros duplicados existem em uma tabela do Analytics.

Sintaxe

DUPLICATES <ON> {campo_chave <D> <...n>|ALL} <OTHER campo <...n>|OTHER ALL> <UNFORMATTED> <TO {SCREEN|nome_tabela|nome_arquivo|PRINT}> <APPEND> <IF teste> <WHILE teste> <FIRST intervalo|NEXT intervalo> <HEADER texto_cabeçalho> <FOOTER texto_rodapé> <PRESORT> <OPEN> <LOCAL> <ISOLOCALE código_local>

Parâmetros

Nome	Descrição
ON campo_chave D <...n> \| ALL	O campo ou campos-chave, ou a expressão, onde será verificada a existência de duplicidades. campo_chave use o campo ou os campos especificados Se você testar em mais de um campo, os registros identificados como duplicidades exigem valores idênticos em todos os campos especificados. Inclua D para ordenar o campo-chave em ordem decrescente. A ordem de classificação-padrão é crescente. ALL use todos os campos na tabela Se você testar em todos os campos de uma tabela, os registros identificados como duplicidades devem ser inteiramente idênticos. Uma ordem de classificação crescente é a única opção para ALL. Nota As partes indefinidas dos registros não são testadas.
OTHER campo <...n> \| OTHER ALL opcional	Um ou mais campos adicionais a serem incluídos na saída. campo <...n> inclua o campo ou os campos especificados ALL inclua todos os campos da tabela que não são especificados como campos-chave
UNFORMATTED opcional	Suprime os cabeçalhos e as quebras de página quando os resultados são enviados a um arquivo.
TO SCREEN \| nome_tabela \| nome_arquivo \| PRINT opcional	A localização para onde enviar os resultados do comando: SCREEN exibe os resultados na área de exibição do Analytics nome_tabela salva os resultados em uma tabela do Analytics Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL" Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente: TO "C:\Saída.FIL" TO "Resultados\Saída.FIL" Nota Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número. nome_arquivo salva os resultados em um arquivo Especifique nome_arquivo como uma cadeia entre aspas com uma extensão de arquivo apropriada. Por exemplo: TO "Saída.TXT" Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics. Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente: TO "C:\Saída.TXT" TO "Resultados\Saída.TXT" PRINT envia os resultados para a impressora padrão
APPEND opcional	Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo. Nota Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos: os mesmos campos a mesma ordem de campos os campos correspondentes têm o mesmo comprimento os campos correspondentes têm o mesmo tipo de dados O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.
IF teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição. Nota O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).
WHILE teste opcional	Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado. Nota Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.
FIRST intervalo \| NEXT intervalo opcional	O número de registros a ser processado: FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado Use intervalo para especificar o número de registros a serem processados. Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.
HEADER texto_cabeçalho opcional	O texto a ser inserido na parte superior de cada página de um relatório. texto_cabeçalho deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema HEADER do Analytics.
FOOTER texto_rodapé opcional	O texto a ser inserido na parte inferior de cada página de um relatório. texto_rodapé deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema FOOTER do Analytics.
PRESORT opcional	Ordena a tabela pelo campo-chave antes de executar o comando. Nota Você não pode usar PRESORT dentro do comando GROUP.
OPEN opcional	Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.
LOCAL opcional	Salva o arquivo de saída no mesmo local que o projeto do Analytics. Nota Aplicável apenas na execução de um comando em uma tabela de servidor com um campo de saída que é uma tabela do Analytics.
ISOLOCALE código_local opcional	Nota Aplicável apenas à edição Unicode do Analytics. A localidade do sistema no formato idioma_país. Por exemplo, para usar francês canadense, insira fr_ca. Use os códigos a seguir: idioma código de idioma padrão ISO 639 país código de país padrão ISO 3166 Se você não especificar um código de país, será usado o país padrão do idioma. Se você não usar ISOLOCALE, a localidade do sistema padrão será usada.

Nome

Descrição

ON campo_chave D <...n> | ALL

O campo ou campos-chave, ou a expressão, onde será verificada a existência de duplicidades.

campo_chave use o campo ou os campos especificados
Se você testar em mais de um campo, os registros identificados como duplicidades exigem valores idênticos em todos os campos especificados.
Inclua D para ordenar o campo-chave em ordem decrescente. A ordem de classificação-padrão é crescente.
ALL use todos os campos na tabela
Se você testar em todos os campos de uma tabela, os registros identificados como duplicidades devem ser inteiramente idênticos.
Uma ordem de classificação crescente é a única opção para ALL.
Nota
As partes indefinidas dos registros não são testadas.

OTHER campo <...n> | OTHER ALL

opcional

Um ou mais campos adicionais a serem incluídos na saída.

campo <...n> inclua o campo ou os campos especificados
ALL inclua todos os campos da tabela que não são especificados como campos-chave

UNFORMATTED

opcional

Suprime os cabeçalhos e as quebras de página quando os resultados são enviados a um arquivo.

TO SCREEN | nome_tabela | nome_arquivo | PRINT

opcional

A localização para onde enviar os resultados do comando:

SCREEN exibe os resultados na área de exibição do Analytics
nome_tabela salva os resultados em uma tabela do Analytics
Especifique nome_tabela como uma cadeia entre aspas com uma extensão de arquivo .FIL. For exemplo: TO "Saída.FIL"
Por padrão, o arquivo de dados da tabela (.fil) é salvo na pasta que contém o projeto do Analytics.
Use um caminho de arquivo absoluto ou relativo para salvar o arquivo de dados em uma pasta diferente já existente:
- TO "C:\Saída.FIL"
- TO "Resultados\Saída.FIL"
Nota
Os nomes de tabela são limitados a 64 caracteres alfanuméricos, sem contar a extensão .FIL. O nome pode incluir o caractere de sublinhado ( _ ) mas nenhum outro caractere especial e nenhum espaço. O nome não pode começar com um número.
nome_arquivo salva os resultados em um arquivo
Especifique nome_arquivo como uma cadeia entre aspas com uma extensão de arquivo apropriada. Por exemplo: TO "Saída.TXT"
Por padrão, o arquivo é salvo na pasta que contém o projeto do Analytics.
Use um caminho de arquivo absoluto ou relativo para salvar o arquivo em uma pasta diferente já existente:
- TO "C:\Saída.TXT"
- TO "Resultados\Saída.TXT"
PRINT envia os resultados para a impressora padrão

APPEND

opcional

Anexa a saída do comando ao final de um arquivo existente, em vez de sobrescrevê-lo.

Nota

Você deve garantir que a estrutura da saída do comando e o arquivo existente são idênticos:

os mesmos campos
a mesma ordem de campos
os campos correspondentes têm o mesmo comprimento
os campos correspondentes têm o mesmo tipo de dados

O Analytics anexa a saída a um arquivo existente, seja qual for sua estrutura. Se a estrutura da saída e do arquivo existente não corresponderem, o resultado poderá ser dados misturados, ausentes ou incorretos.

IF teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado apenas nos registros que atendem à condição.

Nota

O parâmetro IF é avaliado apenas em relação aos registros restantes em uma tabela depois da aplicação dos parâmetros de escopo (WHILE, FIRST, NEXT).

WHILE teste

opcional

Uma expressão condicional que deve ser verdadeira para processar cada registro. O comando é executado até que a condição seja avaliada como falsa ou o fim da tabela seja alcançado.

Nota

Se você usar WHILE juntamente com FIRST ou NEXT, o processamento de registros será interrompido assim que um limite for alcançado.

FIRST intervalo | NEXT intervalo

opcional

O número de registros a ser processado:

FIRST iniciar o processamento a partir do primeiro registro até alcançar o número de registros especificado
NEXT iniciar o processamento a partir do registro selecionado no momento até alcançar o número de registros especificado

Use intervalo para especificar o número de registros a serem processados.

Se você omitir FIRST e NEXT, todos os registros serão processados por padrão.

HEADER texto_cabeçalho

opcional

O texto a ser inserido na parte superior de cada página de um relatório.

texto_cabeçalho deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema HEADER do Analytics.

FOOTER texto_rodapé

opcional

O texto a ser inserido na parte inferior de cada página de um relatório.

texto_rodapé deve ser especificado como uma cadeia entre aspas. O valor substitui a variável de sistema FOOTER do Analytics.

PRESORT

opcional

Ordena a tabela pelo campo-chave antes de executar o comando.

Nota

Você não pode usar PRESORT dentro do comando GROUP.

OPEN

opcional

Abre a tabela criada pelo comando após a execução do comando. Válido apenas se o comando criar uma tabela de saída.

LOCAL

opcional

Salva o arquivo de saída no mesmo local que o projeto do Analytics.

Nota

Aplicável apenas na execução de um comando em uma tabela de servidor com um campo de saída que é uma tabela do Analytics.

ISOLOCALE código_local

opcional

Nota

Aplicável apenas à edição Unicode do Analytics.

A localidade do sistema no formato idioma_país. Por exemplo, para usar francês canadense, insira fr_ca.

Use os códigos a seguir:

idioma código de idioma padrão ISO 639
país código de país padrão ISO 3166
Se você não especificar um código de país, será usado o país padrão do idioma.

Se você não usar ISOLOCALE, a localidade do sistema padrão será usada.

Variáveis de saída do Analytics

Nome	Contém
GAPDUPn	O número total de grupos de falhas, duplicidades ou duplicidades parciais identificados pelo comando.

Exemplos

Testar se há valores duplicados em um campo

O exemplo a seguir:

testa se há valores duplicados no campo Número_Fatura
exibe qualquer registro que contenha números de faturas duplicados em uma nova tabela do Analytics

DUPLICATES ON Número_Fatura OTHER Número_Fornecedor Data_Fatura Valor_Fatura PRESORT TO "Duplicate_Invoices.FIL"

Testar se há valores duplicados em dois ou mais campos em combinação

O exemplo a seguir:

testa se há combinações de valores duplicadas nos campos Número_Fatura e Número_Fornecedor
exibe qualquer registro que contenha o mesmo número de fatura e o mesmo número de fornecedor em uma nova tabela do Analytics

A diferença entre esse teste e o teste anterior é que um número de fatura idêntico de dois fornecedores diferentes não é reportado como um falso positivo.

DUPLICATES ON Número_Fatura Número_Fornecedor OTHER Data_Fatura Valor_Fatura PRESORT TO "Duplicate_Invoices.FIL"

Testar se há registros duplicados

Os exemplos a seguir:

testam se há valores duplicados em todos os campos de uma tabela Inventário
gravam todos os registros inteiramente idênticos em uma nova tabela do Analytics

DUPLICATES ON NumProd ClassProd Local DescProd StatusProd CustoUnidade DataCusto PreçoVenda DataPreço PRESORT TO "Itens_inventário_duplicados.FIL"

Você pode simplificar a sintaxe usando ALL:

DUPLICATES ON ALL PRESORT TO "Itens_inventário_duplicados.FIL"

[ Voltar ao início ]