Referentie voor Tableau Prep-functies
Met functies voor berekening van Tableau Prep kunt u berekende velden maken om nieuwe data te maken met gebruik van data die al in uw databron aanwezig zijn.
Getalfuncties
Syntaxis | Beschrijving |
---|---|
ABS(number) | Retourneert de absolute waarde van het opgegeven getal. Voorbeelden:
|
ACOS(number) | Retourneert de boogcosinus van het opgegeven getal. Het resultaat is in radialen. Voorbeeld:
|
ASIN(number) | Retourneert de boogsinus van een opgegeven getal. Het resultaat is in radialen. Voorbeeld:
|
ATAN(number) | Retourneert de boogtangens van een opgegeven getal. Het resultaat is in radialen. Voorbeeld:
|
ATAN2(y number, x number) | Retourneert de boogtangens van twee opgegeven getallen (x en y ). Het resultaat is in radialen.Voorbeeld:
|
CEILING(number ) | Rondt een getal af tot het dichtstbijzijnde gehele getal met dezelfde of hogere waarde. Voorbeeld:
|
COS(number) | Retourneert de cosinus van een hoek. Geeft de hoek op in radialen. Voorbeeld:
|
COT(angle) | Retourneert de cotangens van een hoek. Geeft de hoek op in radialen. Voorbeeld:
|
DIV(integer1, integer2) | Retourneert het gedeelte geheel getal van een divisiebewerking, waarin integer1 wordt gedeeld door integer2 .Voorbeeld:
|
EXP(number) | Retourneert e tot de macht van het opgegeven getal. Voorbeelden:
|
FLOOR(number) | Rondt een getal af tot het dichtstbijzijnde gehele getal met dezelfde of lagere waarde. Voorbeeld:
|
HEXBINX(number, number) | Wijst een x, y-coördinaat toe aan de x-coördinaat van de dichtstbijzijnde zeshoekige bin. De bins hebben zijlengte 1, dus de invoer moet mogelijk dienovereenkomstig worden geschaald. Voorbeeld:
|
HEXBINY(number, number) | Wijst een x, y-coördinaat toe aan de y-coördinaat van de dichtstbijzijnde zeshoekige bin. De bins hebben de zijlengte 1, dus de invoer moet mogelijk dienovereenkomstig worden geschaald. Voorbeeld:
|
LN(number) | Retourneert het natuurlijke logaritme van een getal. Retourneert null als getal kleiner is dan of gelijk is aan 0. Voorbeeld:
|
LOG(number [, base] ) | Retourneert de logaritme van een getal voor de opgegeven basis. Als de basiswaarde is weggelaten, wordt 10 als basis gebruikt. Voorbeeld:
|
MAX(number, number) | Retourneert het maximum van de twee argumenten. Deze moeten van hetzelfde type zijn. Retourneert Null als een van de argumenten Null is. MAX kan ook worden toegepast op een enkel veld als geaggregeerde berekening.Voorbeelden:
|
MIN(number, number) | Retourneert het minimum van de twee argumenten. Deze moeten van hetzelfde type zijn. Retourneert Null als een van de argumenten Null is. MIN kan ook worden toegepast op een enkel veld als geaggregeerde berekening.Voorbeelden:
|
PI( ) | Retourneert de numeriek constante pi: 3,14159. Voorbeeld:
|
POWER(number, power) | Verhoogt het getal met de opgegeven macht. Voorbeelden:
U kunt het symbool ^ ook gebruiken.
|
RADIANS(number) | Converteert het opgegeven getal van graden naar radialen. Voorbeeld:
|
ROUND(number, [decimals]) | Rondt getallen af tot een bepaald aantal cijfers. Het optionele argument decimalen geeft aan hoeveel decimalen er precies in het eindresultaat moeten worden opgenomen. Als decimalen worden weggelaten, wordt het getal afgerond op het dichtstbijzijnde gehele getal. Voorbeeld: In dit voorbeeld wordt elke Sales-waarde afgerond op een geheel getal:
|
SIGN(number) | Retourneert het teken van een getal: de mogelijke retourwaarden zijn -1 als het getal positief is, 0 als het getal nul is of 1 als het getal positief is. Voorbeeld: Als het gemiddelde van het veld Profit negatief is, dan
|
SIN(number) | Retourneert de sinus van een hoek. Geeft de hoek op in radialen. Voorbeelden:
|
SQRT(number) | Retourneert de vierkantswortel van een getal. Voorbeeld:
|
SQUARE(number) | Retourneert het kwadraat van een getal. Voorbeeld:
|
TAN(number ) | Retourneert de tangens van een hoek. Geeft de hoek op in radialen. Voorbeeld:
|
ZN(expression) | Retourneert de expressie als deze niet null is. Anders wordt nul geretourneerd. Gebruik deze functie om nulwaarden te gebruiken in plaats van null-waarden. Voorbeeld:
|
Tekenreeksfuncties
Syntaxis | Beschrijving |
---|---|
ASCII(string) | Retourneert de ASCII-code voor het eerste teken van een tekenreeks. Voorbeeld:
|
CHAR(number) | Retourneert het teken dat is gecodeerd door het ASCII-codenummer. Voorbeeld:
|
CONTAINS(string, substring) | Retourneert ‘true’ als de gegeven tekenreeks de gespecificeerde subtekenreeks bevat. Voorbeeld:
|
ENDSWITH(string, substring) | Retourneert 'true’ als de opgegeven tekenreeks eindigt op de opgegeven substring . Spaties aan het einde worden genegeerd.Voorbeeld:
|
FIND(string, substring, [start]) | Retourneert de indexpositie van substring in de tekenreeks of 0 als de subtekenreeks niet wordt gevonden. Als het optionele argument Start wordt toegevoegd, negeert de functie alle vermeldingen van een substring die voorkomt vóórdat de startpositie begint. Het eerste teken in de tekenreeks is positie 1.Voorbeelden:
|
FINDNTH(string, substring, occurrence) | Retourneert de positie van de n-de keer dat een subtekenreeks voorkomt in de opgegeven tekenreeks, waarbij n wordt gedefinieerd door het argument voor het aantal vermeldingen. Voorbeeld:
|
ISDATE(string) | Retourneert waar als een opgegeven tekenreeks een geldige datum is. Voorbeeld:
|
LEFT(string, number) | Retourneert het meest linkse getal van de tekens in de tekenreeks. Voorbeeld:
|
LEN(string) | Retourneert de lengte van de tekenreeks. Voorbeeld:
|
LOWER(string) | Retourneert een tekenreeks, waarbij alle tekens kleine letters zijn. Voorbeeld:
|
LTRIM(string) | Retourneert de tekenreeks met eventuele voorloopspaties verwijderd. Voorbeeld:
|
(MID(string, start, [length]) | Retourneert de tekenreeks vanaf de indexpositie Start. Het eerste teken in de tekenreeks is positie 1. Als het optionele numerieke argument Lengte wordt toegevoegd, bevat de geretourneerde tekenreeks alleen dat aantal tekens. Voorbeelden:
|
PROPER(string) | Converteert een tekenreeks van tekst waarbij de eerste letter van elk woord een hoofdletter is en de overige letters een kleine letter. Spaties en niet-alfanumerieke tekens zoals leestekens worden ook als scheidingstekens beschouwd. Voorbeeld:
|
REGEXP_EXTRACT(string, pattern) | Retourneert een subtekenreeks van de opgegeven tekenreeks die overeenkomt met de capturing group binnen het patroon van de reguliere expressie. Het patroon van de reguliere expressie vereist precies één groep voor vastleggen. Voorbeeld:
|
REGEXP_EXTRACT_NTH(string, pattern, index) | Retourneert een subtekenreeks van de opgegeven tekenreeks met gebruikmaking van het patroon van de reguliere expressie. De subtekenreeks wordt afgestemd met de nde groep voor vastleggen, waarbij n de opgegeven index is. Voorbeeld:
|
REGEXP_MATCH(string, pattern) | Retourneert waar als een subtekenreeks van de opgegeven tekenreeks overeenkomt met het patroon van de reguliere expressie. Voorbeeld:
|
REGEXP_REPLACE(string, pattern, replacement) | Retourneert een kopie van de opgegeven tekenreeks waarin het overeenkomende patroon is vervangen door de vervangende tekenreeks. Voorbeeld:
|
REPLACE(string, substring, replacement) | Zoekt in een tekenreeks naar een subtekenreeks en vervangt deze door een vervanging. Als de subtekenreeks niet wordt gevonden, blijft de tekenreeks ongewijzigd. Voorbeeld:
|
RIGHT(string, number) | Retourneert het meest rechtse getal van de tekens in de tekenreeks. Voorbeeld:
|
RTRIM(string) | Retourneert tekenreeks met eventuele naloopspaties verwijderd. Voorbeeld:
|
SPACE(number) | Retourneert een tekenreeks die bestaat uit een opgegeven aantal herhaalde spaties. Voorbeeld:
|
SPLIT(string, delimiter, token number)
| Retourneert een subtekenreeks van een tekenreeks zoals bepaald door een scheidingsteken en extraheert de tekens van het begin of einde van de tekenreeks. Voorbeeld:
|
STARTSWITH(string, substring) | Retourneert ‘true’ als tekenreeks begint met substring . Voorafgaande spaties worden genegeerd.Voorbeeld:
|
TRIM(string) | Retourneert de tekenreeks met de voor- en naloopspaties verwijderd. Voorbeeld:
|
UPPER(string) | Retourneert een tekenreeks, waarbij alle tekens in hoofdletters zijn. Voorbeeld:
|
Geaggregeerde functies
Syntaxis | Beschrijving |
---|---|
AVG(expression) | Retourneert het gemiddelde van alle waarden in de expressie. AVG kan alleen met numerieke velden worden gebruikt. Nullwaarden worden genegeerd Voorbeeld:
|
COUNT(expression) | Retourneert het aantal items in een groep. Nullwaarden worden niet geteld. Voorbeeld:
|
COUNTD(expression) | Retourneert het aantal afzonderlijke items in een groep. Null-waarden worden niet geteld. Elke unieke waarde wordt slechts eenmaal geteld. Voorbeeld:
|
MEDIAN(expression) | Retourneert de mediaan van één expressie. MEDIAN kan alleen met numerieke velden worden gebruikt. Nullwaarden worden genegeerd. Voorbeeld:
|
PERCENTILE(expression, number) | Geaggregeerde berekening die de percentielwaarde retourneert van de opgegeven expressie die overeenkomt met het opgegeven getal. Geldige waarden voor het getal zijn 0 tot en met 1. PERCENTILE([expressie], 0.50) retourneert altijd de mediaanwaarde in de expressie. Voorbeeld:
|
STDEV(expression) | Retourneert de standaardafwijking in de steekproef van de expressie. Voorbeeld:
|
STDEVP(expression) | Retourneert de standaardafwijking in de populatie van de expressie. Voorbeeld:
|
SUM(expression) | Retourneert de som van alle waarden in de expressie. SUM kan alleen met numerieke velden worden gebruikt. Nullwaarden worden genegeerd. Voorbeeld:
|
VAR(expression) | Retourneert de statistische variantie van alle waarden in de gegeven expressie op basis van een steekproef van de populatie. Voorbeeld:
|
VARP(expression) | Retourneert de statistische variantie van alle waarden in de gegeven expressie op basis van de gehele populatie. Voorbeeld:
|
ZN(expression) | Retourneert de expressie als deze niet null is. Anders wordt nul geretourneerd. Gebruik deze functie om nulwaarden te gebruiken in plaats van null-waarden. Voorbeeld:
|
Functies voor typeconversie
Syntaxis | Beschrijving |
---|---|
DATE | Retourneert een datum voor een opgegeven getal, tekenreeks of datumexpressie. Voorbeeld:
De aanhalingstekens zijn vereist. |
DATETIME(expression) | Retourneert een datumtijd op basis van een opgegeven getal, tekenreeks of datumexpressie. Voorbeeld:
De aanhalingstekens zijn vereist. |
FLOAT(expression) | Retourneert een zwevende waarde voor een opgegeven expressie van elk type. Deze functie vereist getallen zonder specifieke notatie, dus zonder komma's en andere symbolen. Voorbeeld:
|
INT(expression) | Retourneert een geheel getal voor een opgegeven expressie. Deze functie kort resultaten in tot het dichtstbijzijnde gehele getal richting nul. Voorbeeld:
|
MAKEDATE(year, month, day) | Retourneert een datumwaarde die is samengesteld uit een jaar, een maand en een dag van de maand. Voorbeeld:
|
MAKEDATETIME(date, time) | Retourneert een datum-en-tijdwaarde voor een datumexpressie en een tijdexpressie. Voorbeeld:
|
MAKETIME(hour, minute, second) | Retourneert een tijdwaarde die is samengesteld uit uren, minuten en seconden. Voorbeeld:
|
STR(expression) | Retourneert een tekenreeks voor een bepaalde expressie. Voorbeeld:
Retourneert alle waarden van de meetwaarde Leeftijd als tekenreeksen. |
Datumfuncties
Syntaxis | Beschrijving |
---|---|
DATEADD(date_part, interval, date) | Voegt een increment aan de opgegeven datum toe en retourneert de nieuwe datum. Het increment wordt gedefinieerd door het interval en het datumgedeelte. Voorbeeld:
|
DATEDIFF(date_part, start_date, end_date, [start_of_week]) | Retourneert het verschil tussen twee datums waarbij de startdatum wordt afgetrokken van de einddatum. Het verschil wordt uitgedrukt in eenheden van het datumgedeelte. Als begin_van_week wordt weggelaten, wordt de begindag van de week bepaald door de begindag die voor de databron is geconfigureerd. Voorbeeld:
|
DATENAME(date_part, date, [start_of_week]) | Retourneert een gedeelte van de opgegeven datum als een tekenreeks, waarbij het gedeelte wordt gedefinieerd door het datumgedeelte. Als begin_van_week wordt weggelaten, wordt de begindag van de week bepaald door de begindag die voor de databron is geconfigureerd. Voorbeeld:
|
DATEPARSE(format, string) | Converteert een tekenreeks naar een datum in de opgegeven notatie. Voorbeeld:
|
DATEPARTT(date_part, date, [start_of_week]) | Retourneert een gedeelte van de opgegeven datum als geheel getal waarbij het gedeelte wordt gedefinieerd door het datumgedeelte. Als begin_van_week wordt weggelaten, wordt de begindag van de week bepaald door de begindag die voor de databron is geconfigureerd. Voorbeeld:
|
DATETRUNC(date_part, date, [start_of_week]) | Kort de opgegeven datum in tot de nauwkeurigheid die is opgegeven door het datumgedeelte en retourneert de nieuwe datum. Als begin_van_week wordt weggelaten, wordt de begindag van de week bepaald door de begindag die voor de databron is geconfigureerd. Voorbeeld:
|
DAY(date) | Retourneert de dag van een opgegeven datum als een geheel getal. Voorbeeld:
|
ISDATE(string) | Retourneert waar als een opgegeven tekenreeks een geldige datum is. Voorbeeld:
|
MONTH(date) | Retourneert de maand van een opgegeven datum als een geheel getal. Voorbeeld:
|
NOW() | Retourneert de huidige datum en tijd. Voorbeeld:
|
TODAY() | Retourneert de huidige datum. Voorbeeld:
|
YEAR(date) | Retourneert het jaar van een opgegeven datum als een geheel getal. Voorbeeld:
|
Logische functies
Syntaxis | Beschrijving |
---|---|
IFNULL(expr1, expr2) | Retourneert <expr1> als dit niet ‘null’ is, anders wordt <expr2> geretourneerd.Voorbeeld:
|
IIF(test, then, else, [unknown]) | Controleert of aan een voorwaarde is voldaan, en retourneert één waarde indien TRUE, een andere waarde indien FALSE, en een optionele derde waarde of NULL indien onbekend. Voorbeeld:
|
ISDATE(string) | Retourneert waar als een opgegeven tekenreeks een geldige datum is. Voorbeeld:
|
ISNULL(expression) | Retourneert 'true’ als de expressie geen geldige data bevat (Null ).Voorbeeld:
|
ZN(expression) | Retourneert de expressie als deze niet null is. Anders wordt nul geretourneerd. Gebruik deze functie om nulwaarden te gebruiken in plaats van null-waarden. Voorbeeld:
|
Analytische functies
Syntaxis | Beschrijving |
---|---|
LAST_VALUE(expression, [return_last_non-null_value]) | Retourneert de laatste waarde van de opgegeven expressie vanaf de eerste rij in de partitie tot de huidige rij. Accepteert een optionele tweede booleaanse waarde om de laatste niet-null-waarde te retourneren. Voorbeeld:
|
LOOKUP(expression, [offset]) | Retourneert de waarde van de opgegeven expressie in een doelrij, opgegeven als een relatieve marge van de huidige rij. Retourneert NULL als de doelrij niet kan worden vastgesteld. De parameter [ Voorbeeld:
Retourneert de SALES-waarde van de vorige rij. |
NTILE(number) | Distribueert rijen in een geselecteerde partitie over een opgegeven aantal groepen of tegels. Met deze functie wordt de set met waarden (6,9,9,14) die is gedistribueerd over 3 tegels, toegewezen aan de tegels (1,2,2,3) in oplopende volgorde. Voorbeeld:
|
RANK() | Retourneert de standaard 'competition'-rang voor de huidige rij in de partitie. Aan identieke waarden wordt een identieke rang toegewezen. Voorbeeld:
|
RANK_DENSE() | Retourneert de 'dense'-rang voor de huidige rij in de partitie. Identieke waarden krijgen een identieke rang, maar in de getallenreeks worden geen openingen ingevoegd. Voorbeeld:
|
RANK_MODIFIED() | Retourneert de aangepaste 'competition'-rang voor de huidige rij in de partitie. Aan identieke waarden wordt een identieke rang toegewezen. Voorbeeld:
|
RANK_PERCENTILE() | Retourneert de percentielrang voor de huidige rij in de partitie. Voorbeeld:
|
ROW_NUMBER() | Retourneert een unieke sequentiële rij-ID voor elke rij. Voorbeeld:
|
RUNNING_AVG(expression) | Retourneert het voortschrijdend gemiddelde van de opgegeven expressie vanaf de eerste rij in de partitie tot de huidige rij. Voorbeeld:
|
RUNNING_SUM(expression) | Retourneert de lopende som van de opgegeven expressie vanaf de eerste rij in de partitie tot de huidige rij. Voorbeeld:
|
Trefwoorden
Functie | Beschrijving |
---|---|
AND | Voert een logische conjunctie uit op twee expressies Voorbeeld:
|
ASC | Definieert de oplopende volgorde voor ORDERBY -bewerkingen.Voorbeeld
|
CASE | Vindt de eerste value die overeenkomt met <expr en retourneert de overeenkomende <return >.Voorbeeld:
|
DESC | Definieert de aflopende volgorde voor ORDERBY -bewerkingen. Voorbeeld:
|
ELSE | Test een reeks expressies en retourneert de waarde <then > voor de eerste ware<expr >. Voorbeeld:
|
ELSEIF | Test een reeks expressies en retourneert de waarde <then > voor de eerste ware<expr >. Gelijk aan het plaatsen van een if -instructie binnen een ELSE-bewerking.Voorbeeld:
|
END | Beëindigt een bewerking die is ingeleid door de overeenkomstige richtlijn. Voorbeeld:
|
{ FIXED } | FIXED-LOD-expressies berekenen waarden met gebruik van de opgegeven dimensies zonder verwijzing naar het weergavedetailniveau. Voorbeeld:
|
IF | Maakt een voorwaardelijke instructie (IF -instructie) en staat u alleen toe om uit te voeren als een voorwaarde ‘True’ is.Voorbeeld:
|
NOT | Voert een logische ontkenning uit op een expressie. Voorbeeld:
|
OR | Voert een logische ontkoppeling uit op twee expressies. Voorbeeld:
|
{ ORDERBY } | Definieert de volgorde die moet worden toegepast op analytische functies. Gebruik het optionele argument asc | desc om oplopende of aflopende volgorde voor elk veld op te geven. Voorbeeld:
|
{ PARTITION } | Definieert de groep waarop analytische functies moeten worden uitgevoerd. ORDERBY moet zich binnen de partitie bevinden. Voorbeeld:
|
THEN | Test een reeks expressies en retourneert de waarde <then > voor de eerste ware<expr >. Voorbeeld:
|
WHEN | Vindt de eerste <value > die overeenkomt met <expr > en retourneert de overeenkomende <return >. Voorbeeld:
|