Delen via

Expressiefuncties in gegevensmappingstromen

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-pijplijnen als Azure Synapse Analytics-pijplijnen. Dit artikel is van toepassing op toewijzingsgegevensstromen. Als u geen ervaring hebt met transformaties, raadpleegt u het inleidende artikel Gegevens transformeren met behulp van toewijzing gegevensstromen.

Dit artikel bevat informatie over expressiefuncties die worden ondersteund door Azure Data Factory en Azure Synapse Analytics in toewijzingsgegevensstromen.

Lijst met expressiefuncties

Gebruik in Azure Data Factory- en Azure Synapse Analytics-pijplijnen de expressietaal van de mappinggegevensstroomfunctie om gegevenstransformaties te configureren.

Expressiefunctie Opdracht
ABS Geeft de 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. Hiermee wordt een duur toegevoegd aan een tijdstempel. Voegt één matrix van vergelijkbaar type toe aan een ander. Hetzelfde als de + operator.
and Maakt gebruik van de 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. U kunt numerieke waarden, tekenreeksen en datetime waarden vergelijken.
bitwiseAnd Maakt gebruik van de bitsgewijze And operator voor integrale typen. Hetzelfde als de & operator.
bitwiseOr Maakt gebruik van de bitsgewijze Or operator voor integrale typen. Hetzelfde als de | operator.
bitwiseXor Maakt gebruik van de bitsgewijze Or operator voor integrale typen. Hetzelfde als de | operator.
blake2b Berekent de Blake2-samenvatting van een set kolommen met verschillende primitieve gegevenstypen wanneer deze een bitlengte krijgt. De bitlengte kan slechts veelvouden zijn van 8 tussen 8 en 512. U kunt deze gebruiken om een vingerafdruk voor een rij te berekenen.
blake2bBinary Berekent de Blake2-samenvatting van een reeks kolommen met verschillende primitieve gegevenstypen wanneer een bitlengte wordt gegeven, die slechts veelvouden van 8 tussen 8 en 512 kan zijn. U kunt deze gebruiken om een vingerafdruk voor een rij te berekenen.
geval Hiermee past u één waarde of de andere toe op basis van afwisselende voorwaarden. Als het aantal invoerwaarden even is, wordt de andere standaard op NULL ingesteld 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 een 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 < of 0 als waarde1 == waarde2 en retourneert een 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 wanneer deze een bitlengte krijgt. De bitlengte moet waarden 0 (256), 224, 256, 384 en 512. U kunt deze gebruiken om een vingerafdruk voor een rij te berekenen.
Graden Converteert radialen naar graden.
verdelen Verdeelt een paar getallen. Hetzelfde als de / operator.
dropLeft Verwijdert het opgegeven aantal tekens van de linkerkant van de tekenreeks. Als de aangevraagde vervolgkeuzelijst groter is dan de lengte van de tekenreeks, wordt een lege tekenreeks geretourneerd.
dropRight Hiermee verwijdert u zo veel tekens als opgegeven aan de rechterkant 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 Maakt gebruik van de gelijkheidsoperator. Hetzelfde als de == operator.
is gelijk aanIgnoreCase Maakt gebruik van de vergelijkingsoperator gelijk aan en negeert hoofdletters. Hetzelfde als de <=> operator.
escape Escapet een tekenreeks op basis van een notatie. Letterlijke waarden voor acceptabele notatie zijn json, xml, ecmascripten htmljava.
expr Resulteert in een expressie uit een tekenreeks. Komt overeen met het schrijven van de expressie in een niet-literale vorm. U kunt deze gebruiken 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 falseis.
vloer Retourneert het grootste gehele getal dat niet groter is dan het getal.
fromBase64 Decodeert de specifieke base64-gecodeerde tekenreeks.
greater Gebruikt de vergelijking groter dan de operator. Hetzelfde als de > operator.
greaterOrEqual Gebruikt de vergelijking groter dan of gelijk aan de operator. Hetzelfde als de >= 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 met behulp van hun naam. Berekende invoer wordt niet ondersteund, maar u kunt parametervervangingen gebruiken.
hasError Controleert of de assert met de opgegeven id is gemarkeerd als een fout.
iif De ene waarde of de andere waarde wordt toegepast op basis van een voorwaarde. Als de andere niet is opgegeven, wordt de waarde beschouwd NULL. Beide waarden moeten compatibel zijn (bijvoorbeeld numeriek of tekenreeks).
iifNull Retourneert het eerste niet-null-item wanneer twee of meer invoeren worden gegeven. 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 gebaseerd) van de subtekenreeks binnen een tekenreeks. Als deze niet wordt gevonden, wordt 0 geretourneerd.
isDelete Controleert of de rij is gemarkeerd voor verwijderen. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet ofwel 1 of 2, en de standaardwaarde is 1.
isError Controleert of de rij is gemarkeerd als fout. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De stream-index moet ofwel 1 of 2 zijn. De standaardwaarde is 1.
isIgnore Controleert of de rij moet worden genegeerd. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De stream-index moet een 1 of een 2 zijn. De standaardwaarde is 1.
isInsert Controleert of de rij is gemarkeerd voor invoegen. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet ofwel 1 of 2 zijn. De standaardwaarde is 1.
isMatch Controleert of de rij overeenkomt met de zoekactie. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet de 1 of 2 zijn. De standaardwaarde is 1.
isNull Controleert of de waarde is NULL.
isUpdate Controleert of de rij is gemarkeerd voor update. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De streamindex moet een 1 of een 2 zijn. De standaardwaarde is 1.
isUpsert Controleert of de rij is gemarkeerd voor invoegen. Voor transformaties die meer dan één invoerstroom nemen, kunt u de (op 1 gebaseerde) index van de stream doorgeven. De stream-index moet ofwel 1 of 2 zijn. De standaardwaarde is 1.
jaro Listener Hiermee haalt u de Afstand van Jaro Listener tussen twee tekenreeksen op.
minst Maakt gebruik van de vergelijking die kleiner is dan of gelijk is aan de operator. Hetzelfde als de <= operator.
Links Extraheert een subtekenreeks die begint bij de index 1 met het aantal tekens. Hetzelfde als SUBSTRING(str, 1, n).
length Retourneert de lengte van de tekenreeks.
minder Maakt gebruik van de vergelijkingsloze operator. Hetzelfde als de < operator.
lesserOrEqual Maakt gebruik van de vergelijking die kleiner is dan of gelijk is aan de operator. Hetzelfde als de <= operator.
levenshtein Hiermee haalt u de levenshtein-afstand tussen twee tekenreeksen op.
als Gebruikt een patroon met een tekenreeks die letterlijk overeenkomt. De uitzondering is het speciale symbool _ dat overeenkomt met één teken in de invoer (vergelijkbaar met .* in posix reguliere expressies).
leggen Bepaalt de positie (op basis van 1) van de subtekenreeks in een tekenreeks die begint op een bepaalde positie. Als de positie wordt weggelaten, begint u bij het begin van de tekenreeks. Als deze niet wordt gevonden, wordt 0 geretourneerd.
log Berekent de logboekwaarde. U kunt een optionele basis of een Euler-nummer opgeven indien gebruikt.
log10 Berekent de logaritmische waarde op basis van grondtal 10.
verlagen Hiermee wordt een tekenreeks in kleine letters weergegeven.
lpad Hiermee wordt de tekenreeks door de opgegeven opvulling opgevuld totdat deze een bepaalde lengte heeft bereikt. Als de tekenreeks gelijk is aan of groter is dan de lengte, wordt de tekenreeks afgekort tot de lengte.
ltrim Links wordt een tekenreeks met voorlooptekens bijgesnoeid. Als de tweede parameter niet is opgegeven, wordt witruimte ingekort. Anders wordt elk opgegeven teken in de tweede parameter afgesneden.
md5 Berekent de MD5-samenvatting van een set kolommen met verschillende primitieve gegevenstypen en retourneert een hextekenreeks van 32 tekens. U kunt deze gebruiken om een vingerafdruk voor een rij te berekenen.
minus Trekt getallen af. Hiermee wordt het aantal dagen afgetrokken van een datum. Trekt de duur af van een tijdstempel. Trekt twee tijdstempels af om het verschil in milliseconden op te halen. Hetzelfde als de - operator.
Mod Geeft de modulus van een paar getallen. Hetzelfde als de % operator.
vermenigvuldigen Vermenigvuldigt een 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 nummer is alleen opeenvolgend binnen een partitie en wordt voorafgegaan door de partitie-ID.
normaliseren Normaliseert de tekenreekswaarde om geaccenteerde Unicode-tekens te scheiden.
niet Maakt gebruik van de logische negatieoperator.
notEquals Maakt gebruik van de vergelijkingsoperator die niet gelijk is aan. Hetzelfde als de != operator.
nul Retourneert een NULL waarde. Gebruik de functie syntax(null()) als er een kolom met de naam nullis. Elke bewerking die deze gebruikt, resulteert in een NULL.
or Maakt gebruik van de logische OR operator. Hetzelfde als ||.
pMod Geeft de positieve modulus van een 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 wanneer een optionele seed binnen een partitie wordt gegeven. Het seed moet een vaste waarde zijn en wordt gebruikt met de partitie-id om willekeurige waarden te produceren.
regexExtract Extraheert een overeenkomende subtekenreeks voor een specifiek regex-patroon. Met de laatste parameter wordt de matchgroep geïdentificeerd en wordt standaard 1 als u dit weglaat. Gebruik `<regex>` om een string te matchen zonder te escapen.
regexMatch Controleert of de tekenreeks overeenkomt met het specifieke regex-patroon. Gebruik `<regex>` om een string te matchen zonder te escapen.
regexReplace Vervangt alle exemplaren van een regex-patroon door een andere subtekenreeks in de specifieke tekenreeks. Gebruik `<regex>` om een string te matchen zonder te escapen.
regexSplit Splitst een tekenreeks op basis van een scheidingsteken op basis van regex en retourneert een matrix met tekenreeksen.
replace Vervangt alle exemplaren van een subtekenreeks door een andere subtekenreeks in de specifieke tekenreeks. Als de laatste parameter wordt weggelaten, wordt standaard een lege tekenreeks gebruikt.
reverse Retourneert een tekenreeks.
Rechts Extraheert een subtekenreeks door tekens vanaf de rechterkant te tellen. Hetzelfde als SUBSTRING(str, LENGTH(str) - n, n).
rlike Controleert of de tekenreeks overeenkomt met het specifieke regex-patroon.
rond Rondt een getal af wanneer een optionele schaal en een optionele afrondingsmodus worden gegeven. 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).
rpad Met de rechtermuisknop wordt de tekenreeks door de opgegeven opvulling gebruikt totdat deze van een bepaalde lengte is. Als de tekenreeks gelijk is aan of groter is dan de lengte, wordt de tekenreeks afgekort tot de lengte.
rtrim Rechts wordt een tekenreeks met volgtekens bijsnijden. Als de tweede parameter niet is opgegeven, wordt witruimte ingekort. Anders wordt elk opgegeven teken in de tweede parameter afgesneden.
sha1 Berekent de SHA-1-samenvatting van een set kolommen met verschillende primitieve gegevenstypen en retourneert een hextekenreeks van 40 tekens. U kunt deze gebruiken om een vingerafdruk voor een rij te berekenen.
sha2 Berekent de SHA-2-samenvatting van een set kolommen met verschillende primitieve gegevenstypen wanneer een bitlengte is gegeven, die alleen de waarden 0 (256), 224, 256, 384 en 512 kan zijn. U kunt deze gebruiken 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. Wanneer de lengte wordt weggelaten, wordt standaard het einde van de tekenreeks gebruikt.
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 Hiermee vervangt u een reeks tekens door een andere set tekens in de tekenreeks. Tekens hebben een directe vervanging.
trim Hiermee wordt een tekenreeks met voorloop- en volgtekens bijsnijden. Als de tweede parameter niet is opgegeven, wordt witruimte ingekort. Anders wordt elk opgegeven teken in de tweede parameter afgesneden.
waar Retourneert altijd een werkelijke waarde. Gebruik de functie syntax(true()) als een kolom een naam trueheeft.
typeMatch Komt overeen met het type kolom. Wordt alleen gebruikt in patroonexpressies. Getal komt overeen met korte getallen, gehele getallen, lang, dubbel, zwevend of decimaal. Integraal komt overeen met kort, geheel getal en lang. Een breuk stemt overeen met double, float en decimaal. Datum/tijd komt overeen met het datum- of tijdstempeltype.
unescape Maakt een string ontvlucht volgens een formaat. Letterlijke waarden voor acceptabele notatie zijn json, xml, ecmascripten htmljava.
bovenste Hoofdletters van een tekenreeks.
uuid Retourneert de gegenereerde UUID.
Xor Geeft de logische XOR operator. Hetzelfde als de ^ operator.

Gerelateerde inhoud

  • Last updated on