SUBSTRING (SSIS-expressie)

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

Retourneert het deel van een tekenexpressie die begint op de opgegeven positie en de opgegeven lengte heeft. De positieparameter en de lengteparameter moeten resulteren in gehele getallen.

Syntaxis

  
SUBSTRING(character_expression, position, length)  

Arguments

character_expression
Is een tekenexpressie waaruit tekens moeten worden geëxtraheerd.

positie
Is een geheel getal dat aangeeft waar de subtekenreeks begint.

length
Is een geheel getal dat de lengte van de subtekenreeks aangeeft als aantal tekens.

Resultaattypen

DT_WSTR

Opmerkingen

SUBSTRING gebruikt een op een gebaseerde index. Als de positie 1 is, begint de subtekenreeks met het eerste teken in character_expression.

SUBSTRING werkt alleen met het DT_WSTR gegevenstype. Een character_expression-argument dat een letterlijke tekenreeks of een gegevenskolom met het gegevenstype DT_STR is, wordt impliciet omgezet in het gegevenstype DT_WSTR voordat SUBSTRING de bewerking uitvoert. Andere gegevenstypen moeten expliciet worden omgezet in het DT_WSTR gegevenstype. Zie Integration Services-gegevenstypen en Cast (SSIS Expression) voor meer informatie.

SUBSTRING retourneert een nulresultaat als het argument null is.

Alle argumenten in de expressie kunnen variabelen en kolommen gebruiken.

Het argument lengte kan de lengte van de tekenreeks overschrijden. In dat geval retourneert de functie de rest van de tekenreeks.

Voorbeelden van expressies

In dit voorbeeld worden twee tekens geretourneerd, beginnend met teken 4, uit een letterlijke tekenreeks. Het geretourneerde resultaat is 'ph'.

SUBSTRING("elephant",4,2)  

In dit voorbeeld wordt de rest van een letterlijke tekenreeks geretourneerd, beginnend bij het vierde teken. Het resultaat is 'phant'. Het is geen fout als de lengteargument de lengte van de tekenreeks overschrijdt.

SUBSTRING ("elephant",4,50)  

In dit voorbeeld wordt de eerste letter uit de kolom MiddleName geretourneerd.

SUBSTRING(MiddleName,1,1)  

In dit voorbeeld worden variabelen gebruikt in de positie- en lengteargumenten. Als Begin 1 is en Lengte 5 is, retourneert de functie de eerste vijf tekens in de kolom Naam .

SUBSTRING(Name,@Start,@Length)  

In dit voorbeeld worden de laatste vier tekens uit de variabele PostalCode geretourneerd vanaf het zesde teken.

SUBSTRING (@PostalCode,6,4)  

In dit voorbeeld wordt een tekenreeks met lengte nul geretourneerd uit een letterlijke tekenreeks.

SUBSTRING ("Redmond",4,0)  

Zie ook

Functies (SSIS-Expressie)