Ga naar hoofdinhoud

Exists - scriptfunctie

Exists() bepaalt of een specifieke veldwaarde al is geladen in het veld in het load-script. De functie retourneert TRUE  of FALSE, zodat deze kan worden gebruikt in de where-clausule van een LOAD -opdracht of een IF-functie.

Opmerking: U kunt Not Exists() ook gebruiken om te bepalen of een veldwaarde niet is geladen, maar voorzichtigheid is geboden als u Not Exists() gebruikt in een where-clausule. De functie Exists() test zowel eerder geladen tabellen als eerder geladen waarden in de huidige tabel. Dit betekent dat alleen het eerste exemplaar wordt geladen. Wanneer een tweede exemplaar wordt gevonden, is de waarde al geladen. Bekijk de voorbeelden voor meer informatie.

Syntax:  

Exists(field_name [, expr] )

Retourgegevenstype: Booleaanse waarde

Arguments:  

Argumenten voor exists
Argument Beschrijving
field_name

De naam van het veld waarin u een waarde wilt zoeken. U kunt een expliciete veldnaam gebruiken zonder aanhalingstekens.

Het veld moet al door het script zijn geladen. Dit betekent dat u niet naar een veld kunt verwijzen dat in een clausule verderop in het script wordt geladen.

expr

De waarde waarvan u wilt controleren of deze bestaat. U kunt een expliciete waarde gebruiken of een uitdrukking die verwijst naar een of meer velden in de huidige laadinstructie.

Opmerking: U kunt niet verwijzen naar velden die niet in de huidige laadinstructie zijn opgenomen.

Dit argument is optioneel. Als u dit weglaat, controleert de functie of de waarde van field_name al bestaat in het huidige record.

Example 1:  

Exists (Employee)

Retourneert -1 (True) als de waarde van het veld Employee in de huidige record al bestaat in een eerder gelezen record met dat veld.

Example 2:  

Exists(Employee, 'Bill')

Retourneert -1 (True) als de veldwaarde 'Bill' wordt gevonden in de huidige inhoud van het veld Employee.

De opdrachten Exists (Employee, Employee) en Exists (Employee) zijn equivalent.

Example 3:  

Employees:
LOAD * inline [ Employee|ID|Salary Bill|001|20000 John|002|30000 Steve|003|35000 ] (delimiter is '|');   Citizens: Load * inline [ Employee|Address Bill|New York Mary|London Steve|Chicago Lucy|Madrid Lucy|Paris John|Miami ] (delimiter is '|') where Exists (Employee);   Drop Tables Employees;
 

Dit resulteert in een tabel met de naam EmployeeAddresses in het gegevensmodel, die kan worden bekeken als een tabelgrafiek met de dimensies Employee en Address.

De clausule where: where Exists (Employee, Name), betekent dat alleen de namen uit de tabel Citizens die tevens in Employees voorkomen in de nieuwe tabel worden geladen. Met de opdracht Drop worden de tijdelijke tabellen Employees en Citizens verwijderd om verwarring te voorkomen.

Resultaten voorbeeld 3
EmployeeAddress
BillNew York
JohnMiami
SteveChicago

Example 4:  

De opdrachten in de voorbeeldgegevens in het vorige voorbeeld waarmee de tabel EmployeeAddresses wordt samengesteld worden hierbij vervangen door de volgende, met behulp van where not Exists.

NonEmployee:

Load Name as Employee, Address Resident Citizens where not Exists (Employee, Name);

 

De clausule where bevat not: where not Exists (Employee, Name).

Dit betekent dat alleen de namen uit de tabel Citizens die niet in Employees voorkomen in de nieuwe tabel worden geladen.

Er zijn twee waarden voor Lucy in de tabel Citizens, maar slechts één waarde wordt opgenomen in de resultaattabel. Als u de eerste rij laadt, wordt de waarde opgenomen in de symbooltabel Employee. Als de tweede regel wordt gecontroleerd, is de waarde nu aanwezig.

In het volgende voorbeeld wordt getoond hoe u alle waarden kunt laden.

Resultaten voorbeeld 4
EmployeeAddress
MaryLondon
LucyMadrid

Example 5:  

Employees: Load Employee As Name, ID, Salary; LOAD * inline [ Employee|ID|Salary Bill|001|20000 John|002|30000 Steve|003|35000 ] (delimiter is '|');   Citizens: Load * inline [ Employee|Address Bill|New York Mary|London Steve|Chicago Lucy|Madrid Lucy|Paris John|Miami ] (delimiter is '|') where not Exists (Name, Employee);   Drop Tables Employees;
 

U moet twee dingen veranderen om alle waarden voor Lucy te krijgen.

  • Voeg een voorafgaande load toe aan Employees en wijzig de naam van Employee in Name.

    Load Employee As Name, ID, Salary;

  • Wijzig de Where-conditie in Citizens in:

    not Exists (Name, Employee).

Hierdoor worden andere symbooltabellen voor Name en Employee aangemaakt. Als de tweede rij voor Lucy wordt gecontroleerd, is deze nog steeds niet aanwezig in Name.

Resultaten voorbeeld 5
EmployeeAddress
MaryLondon
LucyMadrid
LucyParis

Gebruikte gegevens in voorbeeld:

LOAD * inline [ Employee|ID|Salary Bill|001|20000 John|002|30000 Steve|003|35000 ] (delimiter is '|');   Citizens: Load * inline [ Employee|Address Bill|New York Mary|London Steve|Chicago Lucy|Madrid Lucy|Paris John|Miami ] (delimiter is '|');