TOKEN (SSIS Expression)

van toepassing op:SQL Server SSIS Integration Runtime in Azure Data Factory

Retourneert een token (subtekenreeks) van een tekenreeks op basis van de opgegeven scheidingstekens die tokens in de tekenreeks scheiden en het nummer van het token dat aangeeft welk token moet worden geretourneerd.

Syntaxis

TOKEN(character_expression, delimiter_string, occurrence)  

Arguments

character_expression
Een tekenreeks die tokens bevat, gescheiden door scheidingstekens.

delimiter_string
Een tekenreeks die begrenzingstekens bevat. '; ' bevat bijvoorbeeld drie scheidingstekens, puntkomma's, een lege spatie en een komma.

occurrence
Een ondertekend of niet-ondertekend geheel getal waarmee het token wordt opgegeven dat moet worden geretourneerd. Als u bijvoorbeeld 3 opgeeft als een waarde voor deze parameter, wordt het derde token in de tekenreeks geretourneerd.

Resultaattypen

DT_WSTR

Opmerkingen

Deze functie splitst de <character_expression> tekenreeks op in een set tokens, gescheiden door de scheidingstekens die zijn opgegeven in de <delimiter_string> en retourneert vervolgens het Nth-token waarbij N het aantal exemplaren is van het token dat is opgegeven door de <exemplaarparameter> . Zie de sectie Voorbeelden voor voorbeeldgebruik van deze functie.

De volgende opmerkingen zijn van toepassing op de functie TOKEN:

• De scheidingstekenreeks kan een of meer scheidingstekens bevatten.

• Als de waarde van de parameter <voorkomens> hoger is dan het totale aantal tokens in de tekenreeks, retourneert de functie NULL.

• Voorlooptekens worden overgeslagen.

• TOKEN werkt alleen met het DT_WSTR gegevenstype. Een character_expression argument dat een letterlijke tekenreeks of een gegevenskolom met het DT_STR gegevenstype is, wordt impliciet omgezet in het DT_WSTR gegevenstype voordat token de bewerking uitvoert. Andere gegevenstypen moeten expliciet worden omgezet in het DT_WSTR gegevenstype.

• TOKEN retourneert een null-resultaat als de character_expression null is.

• U kunt variabelen en kolommen gebruiken als waarden van alle argumenten in de expressie.

Voorbeelden van expressies

In het volgende voorbeeld retourneert de functie TOKEN 'a'. De tekenreeks "een kleine witte hond" heeft 4 tokens "a", "little", "white", "dog" gescheiden door het scheidingsteken " " (spatieteken). Het tweede argument, een tekenreeks met scheidingstekens, geeft slechts één scheidingsteken, het spatieteken, op dat moet worden gebruikt bij het splitsen van de invoertekenreeks in tokens. Het laatste argument, 1, geeft aan dat het eerste token moet worden geretourneerd. Het eerste token is 'a' in deze voorbeeldtekenreeks.

TOKEN("a little white dog"," ",1)  

In het volgende voorbeeld retourneert de functie TOKEN 'dog'. De tekenreeks met scheidingstekens in dit voorbeeld bevat vijf scheidingstekens. De invoertekenreeks bevat 4 tokens: "een", "kleine", "witte", "hond".

TOKEN("a:little|white dog","| ,.:",4)  

In het volgende voorbeeld retourneert de functie TOKEN '' (een lege tekenreeks), omdat er geen 99 tokens in de tekenreeks staan.

TOKEN("a little white dog"," ",99)  

In het volgende voorbeeld retourneert de functie TOKEN de volledige tekenreeks. De functie doorzoekt de invoertekenreeks naar scheidingstekens en omdat er geen aanwezig zijn, wordt de gehele invoertekenreeks als het eerste token toegevoegd.

TOKEN("a little white dog","|",1)  

In het volgende voorbeeld retourneert de functie TOKEN 'a'. Alle voorlooptekens worden genegeerd.

TOKEN("        a little white dog", " ", 1)  

In het volgende voorbeeld retourneert de functie TOKEN het jaar van een datumtekenreeks.

TOKEN("2009/01/01", "/", 1)

In het volgende voorbeeld retourneert de functie TOKEN de bestandsnaam van het opgegeven pad. Als de waarde van User::P ath bijvoorbeeld 'c:\program files\data\myfile.txt', retourneert de functie TOKEN 'myfile.txt'. De functie TOKENCOUNT retourneert 4 en de functie TOKEN retourneert het 4e token,myfile.txt'.

TOKEN(@[User::Path], "\\", TOKENCOUNT(@[User::Path], "\\"))  

Zie ook

Functies (SSIS-Expressie)