Share via


Expressiefuncties in toewijzingsgegevensstroom

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

Gegevensstromen zijn beschikbaar in Zowel Azure Data Factory als Azure Synapse Pipelines. Dit artikel is van toepassing op toewijzingsgegevensstromen. Als u geen ervaring hebt met transformaties, raadpleegt u het inleidende artikel Gegevens transformeren met behulp van een toewijzingsgegevensstroom.

De volgende artikelen bevatten informatie over expressiefuncties die worden ondersteund door Azure Data Factory en Azure Synapse Analytics in toewijzingsgegevensstromen.

Lijst met expressiefuncties

Gebruik in Data Factory- en Synapse-pijplijnen de expressietaal van de functie toewijzingsgegevensstroom om gegevenstransformaties te configureren.

Expressiefunctie Opdracht
ABS Absolute waarde van een getal.
acos Berekent een inverse cosinuswaarde.
add Hiermee voegt u een paar tekenreeksen of getallen toe. Hiermee wordt een datum toegevoegd aan een aantal dagen. Voegt een duur toe aan een tijdstempel. Voegt één matrix van vergelijkbaar type toe aan een ander. Hetzelfde als de +-operator.
and Logische AND-operator. Hetzelfde als &&.
asin Berekent een inverse sinuswaarde.
assertErrorMessages Retourneert een kaart van alle assertieberichten.
atan Berekent een inverse tangenswaarde.
atan2 Berekent de hoek in radialen tussen de positieve x-as van een vlak en het punt dat door de coördinaten wordt opgegeven.
tussen Controleert of de eerste waarde zich tussen twee andere waarden bevindt. Numerieke, tekenreeks- en datum/tijd-waarden kunnen worden vergeleken
bitwiseAnd Bitwise and operator across integral types. Hetzelfde als & operator.
bitwiseOr Bitwise Or operator over integrale typen. Hetzelfde als | bediener.
bitwiseXor Bitwise Or operator over integrale typen. Hetzelfde als | bediener.
blake2b Berekent de Blake2-samenvatting van een set kolommen met verschillende primitieve gegevenstypen op basis van een bitlengte. De bitlengte kan slechts veelvouden zijn van 8 tussen 8 en 512. Deze kan worden gebruikt om een vingerafdruk voor een rij te berekenen.
blake2bBinary Berekent de Blake2-samenvatting van een set kolommen met verschillende primitieve gegevenstypen met een bitlengte, die slechts veelvouden van 8 tussen 8 en 512 kan zijn. Het kan worden gebruikt om een vingerafdruk voor een rij te berekenen
geval Op basis van afwisselende voorwaarden wordt één waarde of de andere waarde toegepast. Als het aantal invoerwaarden even is, wordt de andere standaard ingesteld op NULL voor de laatste voorwaarde.
cbrt Berekent de kubushoofdmap van een getal.
ceil Retourneert het kleinste gehele getal dat niet kleiner is dan het getal.
samensmelten Retourneert de eerste niet null-waarde van een set invoerwaarden. Alle invoer moet van hetzelfde type zijn.
columnNames Hiermee haalt u de namen op van alle uitvoerkolommen voor een stream. U kunt een optionele stroomnaam doorgeven als het eerste argument en optioneel tweede argument om alleen schemadriftkolommen te retourneren.
Kolommen Hiermee haalt u de waarden van alle uitvoerkolommen voor een stream op. U kunt een optionele stroomnaam doorgeven als het tweede argument.
vergelijken Vergelijkt twee waarden van hetzelfde type. Retourneert een negatief geheel getal als waarde1 < waarde2, 0 als waarde1 == waarde2, positieve waarde als waarde1 > waarde2.
concat Voegt een variabel aantal tekenreeksen samen. Hetzelfde als de +-operator met tekenreeksen.
concatWS Voegt een variabel aantal tekenreeksen samen met een scheidingsteken. De eerste parameter is het scheidingsteken.
Cos Berekent een cosinuswaarde.
ploertendoder Berekent een cosinus hyperbolicus van een waarde.
crc32 Berekent de CRC32-hash van een set kolommen met verschillende primitieve gegevenstypen op basis van een bitlengte. De bitlengte moet waarden 0 (256), 224, 256, 384 of 512 zijn. Deze kan worden gebruikt om een vingerafdruk voor een rij te berekenen.
Graden Converteert radialen naar graden.
verdelen Verdeelt paar getallen. Hetzelfde als de / operator.
dropLeft Hiermee verwijdert u net zoveel tekens links van de tekenreeks. Als de aangevraagde vervolgkeuzelijst groter is dan de lengte van de tekenreeks, wordt een lege tekenreeks geretourneerd.
dropRight Hiermee verwijdert u net zoveel tekens rechts van de tekenreeks. Als de aangevraagde vervolgkeuzelijst groter is dan de lengte van de tekenreeks, wordt een lege tekenreeks geretourneerd.
endsWith Controleert of de tekenreeks eindigt op de opgegeven tekenreeks.
is gelijk aan Vergelijking is gelijk aan operator. Gelijk aan == operator.
is gelijk aanIgnoreCase Vergelijking is gelijk aan operator, waarbij hoofdletters en kleine letters worden genegeerd. Gelijk aan <=> operator.
escape Escapet een tekenreeks op basis van een notatie. Letterlijke waarden voor acceptabele indeling zijn 'json', 'xml', 'ecmascript', 'html', 'java'.
expr Resulteert in een expressie uit een tekenreeks. Het is gelijk aan het schrijven van de expressie in een niet-letterlijke vorm en kan worden gebruikt om parameters door te geven als tekenreeksweergaven.
faculteit Berekent de faculteit van een getal.
vals Retourneert altijd een onwaar-waarde. Gebruik de functie syntax(false()) als er een kolom met de naam false is.
vloer Retourneert het grootste gehele getal dat niet groter is dan het getal.
fromBase64 Decodeert de opgegeven base64-gecodeerde tekenreeks.
greater Vergelijking van een grotere operator. Hetzelfde als > de operator.
greaterOrEqual Vergelijking groter dan of gelijk aan operator. Gelijk aan >= operator.
grootste Retourneert de grootste waarde in de lijst met waarden als invoer die null-waarden overslaat. Retourneert null als alle invoer null is.
hasColumn Hiermee wordt gecontroleerd op een kolomwaarde op naam in de stream. U kunt een optionele stroomnaam doorgeven als het tweede argument. Kolomnamen die bekend zijn tijdens het ontwerp, moeten alleen worden geadresseerd door hun naam. Berekende invoer wordt niet ondersteund, maar u kunt parametervervangingen gebruiken.
hasError Controleert of de assert met de opgegeven id is gemarkeerd als fout.
iif Op basis van een voorwaarde wordt één waarde of de andere waarde toegepast. Als andere niet is opgegeven, wordt deze beschouwd als NULL. Beide waarden moeten compatibel zijn (numeriek, tekenreeks...).
iifNull Met twee of meer invoer wordt het eerste niet null-item geretourneerd. Deze functie is gelijk aan coalesce.
initCap Converteert de eerste letter van elk woord naar hoofdletters. Woorden worden geïdentificeerd als gescheiden door witruimte.
Instr Hiermee zoekt u de positie(1) van de subtekenreeks binnen een tekenreeks. 0 wordt geretourneerd als deze niet wordt gevonden.
isDelete Controleert of de rij is gemarkeerd voor verwijderen. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
isError Controleert of de rij is gemarkeerd als fout. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
isIgnore Controleert of de rij is gemarkeerd om te worden genegeerd. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
isInsert Controleert of de rij is gemarkeerd voor invoegen. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
isMatch Controleert of de rij overeenkomt met de zoekactie. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
isNull Controleert of de waarde NULL is.
isUpdate Controleert of de rij is gemarkeerd voor update. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
isUpsert Controleert of de rij is gemarkeerd voor invoegen. Voor transformaties die meer dan één invoerstroom gebruiken, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet 1 of 2 zijn en de standaardwaarde is 1.
jaro Listener Hiermee haalt u de Afstand van Jaro Listener tussen twee tekenreeksen op.
minst Vergelijking kleiner dan of gelijk aan operator. Gelijk aan <= operator.
Links Extraheert een subtekenreeks die begint bij index 1 met het aantal tekens. Hetzelfde als SUBSTRING(str, 1, n).
length Retourneert de lengte van de tekenreeks.
minder Vergelijking minder operator. Hetzelfde als < de operator.
lesserOrEqual Vergelijking kleiner dan of gelijk aan operator. Gelijk aan <= operator.
levenshtein Hiermee haalt u de levenshtein-afstand tussen twee tekenreeksen op.
als Het patroon is een tekenreeks die letterlijk overeenkomt. De uitzonderingen zijn de volgende speciale symbolen: _ komt overeen met een willekeurig teken in de invoer (vergelijkbaar met. in posix reguliere expressies)
leggen Hiermee zoekt u de positie (1) van de subtekenreeks binnen een tekenreeks die een bepaalde positie start. Als de positie wordt weggelaten, wordt deze beschouwd vanaf het begin van de tekenreeks. 0 wordt geretourneerd als deze niet wordt gevonden.
log Berekent de logboekwaarde. Een optionele basis kan anders een Euler-nummer worden opgegeven indien gebruikt.
log10 Berekent de logboekwaarde op basis van 10 basis.
verlagen Hiermee wordt een tekenreeks in kleine letters weergegeven.
lpad Links vult de tekenreeks door de opgegeven opvulling totdat deze van een bepaalde lengte is. Als de tekenreeks gelijk is aan of groter is dan de lengte, wordt deze bijgesneden op de lengte.
ltrim Links wordt een tekenreeks met voorlooptekens bijgesnoeid. Als de tweede parameter niet is opgegeven, wordt witruimte geknipt. Anders wordt elk teken dat is opgegeven in de tweede parameter, bijsnijden.
md5 Berekent de MD5-samenvatting van een set kolommen met verschillende primitieve gegevenstypen en retourneert een hextekenreeks van 32 tekens. Deze kan worden gebruikt om een vingerafdruk voor een rij te berekenen.
minus Trekt getallen af. Het aantal dagen aftrekken van een datum. De duur van een tijdstempel aftrekken. Trek twee tijdstempels af om het verschil in milliseconden op te halen. Hetzelfde als de operator - .
Mod Modulus van paar getallen. Hetzelfde als de operator %.
vermenigvuldigen Vermenigvuldigt het paar getallen. Hetzelfde als de *-operator.
ontkennen Onderhandelt een getal. Hiermee worden positieve getallen omgezet in negatief en omgekeerd.
nextSequence Retourneert de volgende unieke reeks. Het getal wordt alleen opeenvolgend binnen een partitie en wordt voorafgegaan door de partitionId.
normaliseren Normaliseert de tekenreekswaarde om accentige Unicode-tekens te scheiden.
niet Logische negatieoperator.
notEquals Vergelijking is niet gelijk aan operator. Hetzelfde als != operator.
nul Retourneert een NULL-waarde. Gebruik de functie syntax(null()) als er een kolom met de naam null is. Elke bewerking die wordt gebruikt, resulteert in een NULL.
or Logische OF-operator. Hetzelfde als ||.
pMod Positieve Modulus van paar getallen.
partitionId Retourneert de huidige partitie-id waarin de invoerrij zich bevindt.
macht Verhoogt één getal tot de macht van een ander.
Radialen Converteert graden naar radialen
willekeurig Retourneert een willekeurig getal op basis van een optioneel seed binnen een partitie. Het seed moet een vaste waarde zijn en wordt gebruikt met de partitionId om willekeurige waarden te produceren
regexExtract Extraheer een overeenkomende subtekenreeks voor een bepaald regex-patroon. De laatste parameter identificeert de overeenkomstgroep en wordt standaard ingesteld op 1 als u dit weglaat. Gebruik `<regex>` (back quote) om een tekenreeks te vinden zonder te ontsnappen.
regexMatch Controleert of de tekenreeks overeenkomt met het opgegeven regex-patroon. Gebruik `<regex>` (back quote) om een tekenreeks te vinden zonder te ontsnappen.
regexReplace Vervang alle exemplaren van een regex-patroon door een andere subtekenreeks in de opgegeven tekenreeks Use `<regex>` (back quote) om een tekenreeks te vinden zonder te ontsnappen.
regexSplit Splitst een tekenreeks op basis van een scheidingsteken op basis van regex en retourneert een matrix met tekenreeksen.
replace Vervang alle exemplaren van een subtekenreeks door een andere subtekenreeks in de opgegeven tekenreeks. Als de laatste parameter wordt weggelaten, is deze standaard ingesteld op een lege tekenreeks.
reverse Retourneert een tekenreeks.
Rechts Extraheert een subtekenreeks met het aantal tekens aan de rechterkant. Hetzelfde als SUBSTRING(str, LENGTH(str) - n, n).
rlike Controleert of de tekenreeks overeenkomt met het opgegeven regex-patroon.
rond Rondt een getal af op basis van een optionele schaal en een optionele afrondingsmodus. Als de schaal wordt weggelaten, wordt deze standaard ingesteld op 0. Als de modus wordt weggelaten, wordt deze standaard ingesteld op ROUND_HALF_UP(5). De waarden voor afronding zijn onder meer
rpad Rechts vult de tekenreeks door de opgegeven opvulling totdat deze van een bepaalde lengte is. Als de tekenreeks gelijk is aan of groter is dan de lengte, wordt deze bijgesneden op de lengte.
rtrim Rechts wordt een tekenreeks met volgtekens bijsnijden. Als de tweede parameter niet is opgegeven, wordt witruimte geknipt. Anders wordt elk teken dat is opgegeven in de tweede parameter, bijsnijden.
sha1 Berekent de SHA-1-samenvatting van een set kolommen met verschillende primitieve gegevenstypen en retourneert een hextekenreeks van 40 tekens. Deze kan worden gebruikt om een vingerafdruk voor een rij te berekenen.
sha2 Berekent de SHA-2-samenvatting van een set kolommen met verschillende primitieve gegevenstypen op basis van een bitlengte, die alleen van waarden 0(256), 224, 256, 384, 512 kan zijn. Deze kan worden gebruikt om een vingerafdruk voor een rij te berekenen.
zondigen Berekent een sinuswaarde.
sinh Berekent een sinuswaarde hyperbolicus.
soundex Haalt de soundex code voor de tekenreeks op.
split Splitst een tekenreeks op basis van een scheidingsteken en retourneert een matrix met tekenreeksen.
Sqrt Berekent de vierkantswortel van een getal.
startsWith Controleert of de tekenreeks begint met de opgegeven tekenreeks.
Subtekenreeks Extraheert een subtekenreeks van een bepaalde lengte van een positie. Positie is gebaseerd op 1. Als de lengte wordt weggelaten, wordt deze standaard ingesteld op het einde van de tekenreeks.
subtekenreeksindex Extraheert de subtekenreeks voordat count het scheidingsteken voorkomt. Als count dit positief is, wordt alles links van het eindscheidingsteken (tellend van links) geretourneerd. Als count dit negatief is, wordt alles rechts van het laatste scheidingsteken (tellend van rechts) geretourneerd.
bruinen Berekent een tangenswaarde.
Tanh Berekent een tangenswaarde hyperbolicus.
Vertalen Vervang de ene set tekens door een andere set tekens in de tekenreeks. Tekens bevatten 1 tot 1 vervanging.
trim Hiermee wordt een tekenreeks met voorloop- en volgtekens bijsnijden. Als de tweede parameter niet is opgegeven, wordt witruimte geknipt. Anders wordt elk teken dat is opgegeven in de tweede parameter, bijsnijden.
waar Retourneert altijd een werkelijke waarde. Gebruik de functie syntax(true()) als er een kolom met de naam true is.
typeMatch Komt overeen met het type kolom. Kan alleen worden gebruikt in patroonexpressies.number komt overeen met korte, gehele getallen, lange, dubbele, zwevende of decimale, integrale overeenkomsten voor korte, gehele getallen, lange, breukovereenkomsten met dubbele, float-, decimale en datum/tijd-overeenkomsten met datum- of tijdstempeltype.
unescape Unescapes a string according to a format. Letterlijke waarden voor acceptabele indeling zijn 'json', 'xml', 'ecmascript', 'html', 'java'.
bovenste Hoofdletters van een tekenreeks.
uuid Retourneert de gegenereerde UUID.
Xor Logische XOR-operator. Hetzelfde als de operator ^.