SnowConvert AI – Funktionsreferenzen für Teradata¶

Definition¶

UDF (benutzerdefinierte Funktion), die das Quartal eines bestimmten Datums entsprechend dem ISO-Kalenderjahr berechnet, ähnlich wie die Funktion QUARTERNUMBER_OF_YEAR_UDF(date, ‚ISO‘) von Teradata

PUBLIC.QUARTERNUMBER_OF_YEAR_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TimeSTAMP_TZ

Die Methode zum Extrahieren des Quartals

Rückgabewerte¶

Eine Ganzzahl (1–4), die angibt, in welches Quartal des Jahres das Datum fällt.

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.QUARTERNUMBER_OF_YEAR_UDF(DATE '2022-01-01'),
PUBLIC.QUARTERNUMBER_OF_YEAR_UDF(DATE '2025-12-31');

Ausgabe:

4, 1

Definition¶

Gibt den Tag innerhalb des Jahres für einen bestimmten Zeitstempel zurück. Die Angabe des Tages reicht von 1 bis 365 (oder 366 in Schaltjahren). Diese Funktion verhält sich genauso wie DAYNUMBER_OF_YEAR(DATE, ‚ISO‘).

PUBLIC.DAYNUMBER_OF_YEAR_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Zum Ermitteln des Tages im Jahr anhand eines Datums.

Rückgabewerte¶

Eine ganze Zahl von 1 bis 371

Beispiel¶

Eingabe:

SELECT DAYNUMBER_OF_YEAR(CURRENT_DATE,'ISO');

Ausgabe:

SELECT
PUBLIC.DAYNUMBER_OF_YEAR_UDF(CURRENT_DATE());

Definition¶

Ruft einen Teil des Textes aus einer angegebenen Zeichenfolge ab, indem eine Startposition und eine Länge angegeben werden

PUBLIC.SUBSTR_UDF(BASE_EXPRESSION STRING, START_POSITION FLOAT)

Parameter¶

BASE_EXPRESSION ist ein Zeichenfolgenparameter, der den Basisausdruck für die Operation definiert.

Der Quelltext, aus dem Sie einen Teil extrahieren möchten

START_POSITION: Eine Gleitkommazahl, die die Startposition in der Eingabezeichenfolge angibt

Die Position, an der Sie mit der Extraktion der Zeichen aus der Zeichenfolge beginnen möchten

Rückgabewerte¶

Die Teilzeichenfolge, die enthalten sein muss

Migrationsbeispiel¶

Eingabe:

SELECT SUBSTRING('Hello World!' FROM -2);

Ausgabe:

SELECT
PUBLIC.SUBSTR_UDF('Hello World!', -2);

Definition¶

Überprüft, ob eine Zeichenfolge einen gültigen numerischen Wert enthält

PUBLIC.CHKNUM_UDF(NUM STRING);

Parameter¶

NUM: Eine Zeichenfolge, die eine Zahl darstellt

Die Textzeichenfolge, die überprüft werden muss

Rückgabewerte¶

Gibt 1 zurück, wenn der Eingabeparameter ein gültiger numerischer Wert ist. Wenn die Eingabe keine gültige Zahl ist (z. B. Text oder Sonderzeichen), wird 0 zurückgegeben.

Beispiel¶

SELECT CHKNUM('1032');

Ausgabe:

SELECT
PUBLIC.CHKNUM_UDF('1032');

Definition¶

UDF (benutzerdefinierte Funktion), die die Funktion TD_YEAR_END(DATE) oder TD_YEAR_END(DATE, ‚COMPATIBLE‘) von Teradata repliziert, die den letzten Tag des Jahres für ein bestimmtes Datum zurückgibt.

PUBLIC.TD_YEAR_END_UDF(INPUT date)

Parameter¶

INPUT DATE

Ermittelt den letzten Tag des aktuellen Jahres

Rückgabewerte¶

Der letzte Tag im Dezember (31. Dezember)

Verwendungsbeispiel¶

Eingabe:

SELECT  PUBLIC.TD_YEAR_END_UDF(DATE '2022-01-01'),
PUBLIC.TD_YEAR_END_UDF(DATE '2022-04-12');

Ausgabe:

2022-12-31, 2022-12-31

Definition¶

Eine benutzerdefinierte Funktion (UDF), die die Funktionalität von OVERLAPS OPERATOR implementiert. Diese Funktion vergleicht zwei oder mehr Zeiträume und stellt fest, ob sie sich zeitlich überschneiden.

PERIOD_OVERLAPS_UDF(PERIODS ARRAY)

Parameter¶

PERIODS ist ein Array, das Zeiträume enthält.

Alle Zeitraumausdrücke, die verglichen werden sollen

Rückgabewerte¶

TRUE, wenn alle Zeiträume in der Menge mindestens einen Punkt gemeinsam haben (Überschneidung), ansonsten FALSE

Migrationsbeispiel¶

SELECT
	PERIOD(DATE '2009-01-01', DATE '2010-09-24')
	OVERLAPS
	PERIOD(DATE '2009-02-01', DATE '2009-06-24');

Ausgabe:

SELECT
	PUBLIC.PERIOD_OVERLAPS_UDF(ARRAY_CONSTRUCT(PUBLIC.PERIOD_UDF(DATE '2009-01-01', DATE '2010-09-24') !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!, PUBLIC.PERIOD_UDF(DATE '2009-02-01', DATE '2009-06-24') !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!)) !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!;

Definition¶

Berechnet, in welche Wochennummer innerhalb des aktuellen Quartals ein bestimmtes Datum fällt

PUBLIC.WEEK_NUMBER_OF_QUARTER_COMPATIBLE_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datum, anhand dessen berechnet wird, in welche Woche des Quartals es fällt

Rückgabewerte¶

Eine Ganzzahl, die angibt, in welche Woche des Quartals das Datum fällt (1-13)

Verwendungsbeispiel¶

Eingabe:

SELECT WEEK_NUMBER_OF_QUARTER_COMPATIBLE_UDF(DATE '2022-05-01', 'COMPATIBLE'),
WEEK_NUMBER_OF_QUARTER_COMPATIBLE_UDF(DATE '2022-07-06', 'COMPATIBLE')

Ausgabe:

5, 1

Definition¶

Konvertiert ein Datum in den entsprechenden Monat in römischen Ziffern

PUBLIC.ROMAN_NUMERALS_MONTH_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Das Eingabedatum, aus dem der Monat extrahiert werden soll

Rückgabewerte¶

Ein varchar, das den Monat aus einem bestimmten Datum extrahiert

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.ROMAN_NUMERALS_MONTH_UDF(DATE '2021-10-26');

Ausgabe:

'X'

Definition¶

Eine benutzerdefinierte Funktion (UDF), die das Verhalten von TD_YEAR_BEGIN oder TD_YEAR_BEGIN(DATE, ‚COMPATIBLE‘) imitiert, indem sie den ersten Tag des Jahres für ein bestimmtes Datum zurückgibt

PUBLIC.TD_YEAR_BEGIN_UDF(INPUT DATE)

Parameter¶

INPUT DATE

Ermittelt den ersten Tag des aktuellen Jahres

Rückgabewerte¶

Der erste Tag im Januar

Verwendungsbeispiel¶

Eingabe:

SELECT TD_YEAR_BEGIN(DATE '2022-01-01', 'COMPATIBLE'),
TD_YEAR_BEGIN(DATE '2022-04-12');

Ausgabe:

2022-01-01, 2022-01-01

Definition¶

Gibt den vollständigen Namen eines Monats in der von Ihnen gewählten Formatierung zurück: alle Großbuchstaben, alle Kleinbuchstaben oder nur der erste Buchstabe in Großbuchstaben

PUBLIC.FULL_MONTH_NAME_UDF(INPUT TIMESTAMP_TZ, RESULTCASE VARCHAR)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datumsformat sollte den Monatsnamen anzeigen.

RESULTCASE VARCHAR

Das Format, in dem das Ergebnis angezeigt werden soll. Gültige Optionen sind „uppercase“, „lowercase“ und „firstOnly“.

Rückgabewerte¶

Gibt ein varchar zurück, das den vollständigen Namen eines Monats enthält

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.FULL_MONTH_NAME_UDF(DATE '2021-10-26', 'uppercase');
SELECT PUBLIC.FULL_MONTH_NAME_UDF(DATE '2021-10-26', 'lowercase');
SELECT PUBLIC.FULL_MONTH_NAME_UDF(DATE '2021-10-26', 'firstOnly');

Ausgabe:

OCTOBER
october
October

Definition¶

Konvertiert eine Dezimalzahl (Basis 10) in ihre hexadezimale Darstellung (Basis 16)

TO_BYTES_HEX_UDF(INPUT FLOAT)

Parameter¶

INPUT ist ein Gleitkommazahlparameter.

Die Zahl, die in das Hexadezimalformat konvertiert wird

Rückgabewerte¶

Eine Zeichenfolge, die den Hexadezimalwert darstellt

Verwendungsbeispiel¶

Eingabe:

SELECT TO_BYTES_HEX_UDF('448');

Ausgabe:

01c0

Definition¶

Eine benutzerdefinierte Funktion (UDF), die den P_INTERSECT-Operator repliziert. Diese Funktion vergleicht zwei oder mehr Zeiträume und stellt fest, wo sie sich überschneiden und gibt das gemeinsame Zeitintervall zwischen ihnen zurück.

Weitere Einzelheiten zur Quellfunktion finden Sie in der Dokumentation.

PERIOD_INTERSECT_UDF(PERIODS ARRAY)

Parameter¶

PERIODS ist ein Array, das Zeiträume enthält.

Alle Zeitraumausdrücke, die verglichen werden müssen

Rückgabewerte¶

Der Abschnitt, in dem sich zwei Zeiträume überschneiden oder gemeinsame Daten haben.

Migrationsbeispiel¶

Eingabe:

SELECT
	PERIOD(DATE '2009-01-01', DATE '2010-09-24')
	P_INTERSECT
	PERIOD(DATE '2009-02-01', DATE '2009-06-24');

Ausgabe:

SELECT
	PUBLIC.PERIOD_INTERSECT_UDF(ARRAY_CONSTRUCT(PUBLIC.PERIOD_UDF(DATE '2009-01-01', DATE '2010-09-24') !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!, PUBLIC.PERIOD_UDF(DATE '2009-02-01', DATE '2009-06-24') !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!)) !!!RESOLVE EWI!!! /*** SSC-EWI-TD0053 - SNOWFLAKE DOES NOT SUPPORT THE PERIOD DATATYPE, ALL PERIODS ARE HANDLED AS VARCHAR INSTEAD ***/!!!;

Definition¶

Konvertiert ein Zeitintervall in Sekunden.

PUBLIC.INTERVAL_TO_SECONDS_UDF
(INPUT_PART VARCHAR(30), INPUT_VALUE VARCHAR())

Parameter¶

INPUT_PART ist eine Variable vom Typ VARCHAR, die Eingabedaten speichert.

Die Zeitdauer, die in Sekunden umgerechnet wird.

INPUT_VALUE VARCHAR: Der Eingabeparameter, der Textdaten akzeptiert

Der Zeitintervalltyp für die Konvertierung. Beispiele sind „DAY“, „DAY TO HOUR“ und andere gültige Intervalltypen.

Rückgabewerte¶

Eine Dezimalzahl, die das Zeitintervall in Sekunden angibt

Definition¶

Kombiniert zwei Zeitstempel zu einem einzigen Wert

PUBLIC.TIMESTAMP_ADD_UDF(FIRST_DATE TIMESTAMP_LTZ, SECOND_DATE TIMESTAMP_LTZ)

Parameter¶

FIRST_DATE ist ein Zeitstempelfeld, das sowohl Datums- als auch Zeitinformationen enthält, mit Unterstützung für Zeitzonen (TIMESTAMP_LTZ).

Das Anfangsdatum, an dem dies hinzugefügt wurde

SECOND_DATE ist eine Zeitstempelspalte, die Zeitzoneninformationen enthält (TIMESTAMP_LTZ) (Zeitstempel mit lokaler Zeitzone).

Das Datum, an dem das Element zum zweiten Mal hinzugefügt wurde

Rückgabewerte¶

Ein Zeitstempel, der durch die Kombination der eingegebenen Datumsparameter erzeugt wird

Definition¶

Eine benutzerdefinierte Funktion (UDF), die Multiplikationsoperationen mit Zeitintervallen durchführt

PUBLIC.INTERVAL_MULTIPLY_UDF
(INPUT_PART VARCHAR(30), INPUT_VALUE VARCHAR(), INPUT_MULT INTEGER)

Parameter¶

INPUT_PART ist eine Variable vom Typ VARCHAR, die Eingabedaten speichert.

Der für die Multiplikation verwendete Wert, angegeben als „YEAR TO MONTH“

INPUT_VALUE VARCHAR

Das Intervall, mit dem multipliziert werden soll

INPUT_MULT ist ein Ganzzahlparameter, der als Multiplikator für Eingabewerte dient.

Die Zahl, die in der Multiplikationsoperation verwendet wird

Rückgabewerte¶

Die Ausgabe wird durch Multiplikation eines Zeitintervalls mit einem numerischen Wert berechnet.

Migrationsbeispiel¶

Eingabe:

SELECT INTERVAL '6-10' YEAR TO MONTH * 8;

Ausgabe:

SELECT
PUBLIC.INTERVAL_MULTIPLY_UDF('YEAR TO MONTH', '6-10', 8);

Definition¶

Benutzerdefinierte Funktion (UDF), die die Funktionalität von TD_DAY_OF_WEEK von Teradata repliziert. Einzelheiten über die ursprüngliche Teradata-Funktion finden Sie hier.

PUBLIC.TD_DAY_OF_WEEK_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Datum, aus dem der Wochentag ermittelt werden soll

Rückgabewerte¶

Eine Ganzzahl von 1 bis 7, die den Wochentag angibt, wobei:

• 1 = Sonntag

• 2 = Montag

• 3 = Dienstag

• 4 = Mittwoch

• 5 = Donnerstag

• 6 = Freitag

• 7 = Samstag

Migrationsbeispiel¶

Eingabe:

SELECT td_day_of_week(DATE '2022-03-02');

Ausgabe:

SELECT
PUBLIC.TD_DAY_OF_WEEK_UDF(DATE '2022-03-02');

Definition¶

Berechnet das ISO-Kalenderjahr ab einem bestimmten Datum. Das Ergebnis kann gekürzt werden, indem Sie die Anzahl der zu behaltenden Stellen angeben.

PUBLIC.ISO_YEAR_PART_UDF(INPUT TIMESTAMP_TZ, DIGITS INTEGER)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datum, aus dem das ISO-Jahr zu extrahieren ist

DIGITS: Eine ganze Zahl, die die maximale Anzahl der anzuzeigenden Ziffern angibt

Die Anzahl der gewünschten Dezimalstellen in der Ausgabe

Rückgabewerte¶

Gibt eine Zeichenfolge (varchar) zurück, die das ISO-Jahr eines bestimmten Datums darstellt

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.ISO_YEAR_PART_UDF(DATE '2021-10-26', 3);
SELECT PUBLIC.ISO_YEAR_PART_UDF(DATE '2021-10-26', 2);
SELECT PUBLIC.ISO_YEAR_PART_UDF(DATE '2021-10-26', 1);

Ausgabe:

'021'
'21'
'1'

Definition¶

Berechnet das Zeitintervall zwischen zwei Daten auf der Grundlage des angegebenen Parameters für die Zeiteinheit

PUBLIC.DIFF_TIME_PERIOD_UDF(TIME STRING, PERIOD VARCHAR(50))

Parameter¶

TIME ist ein Datentyp, der zum Speichern von Zeitwerten in Stunden, Minuten, Sekunden und Sekundenbruchteilen verwendet wird. Der Wert wird als Textzeichenfolge gespeichert.

Der Zeitstempel, der als Ankerpunkt verwendet werden soll

PERIOD ist ein Textfeld (VARCHAR), das einen Zeitraum darstellt.

Die für die Erweiterung verwendete Zeitraumspalte

Rückgabewerte¶

Ein numerischer Wert, der das Zeitintervall zwischen zwei Daten angibt

Verwendungsbeispiel¶

Eingabe:

SELECT DIFF_TIME_PERIOD_UDF('SECONDS','2022-11-26 10:15:20.000*2022-11-26 10:15:25.000');

Ausgabe:

5

Definition¶

Berechnet, in welche Wochennummer ein Datum innerhalb seines Quartals fällt, unter Verwendung der ISO-Kalenderstandards Diese Funktion verhält sich identisch mit der Teradata-Funktion WEEKNUMBER_OF_QUARTER(DATE, 'ISO').

PUBLIC.WEEK_NUMBER_OF_QUARTER_ISO_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datum, anhand dessen berechnet wird, in welche Woche des Quartals es fällt

Rückgabewerte¶

Eine Ganzzahl, die angibt, welche Woche des Quartals (1–13) dies darstellt.

Verwendungsbeispiel¶

Eingabe:

SELECT WEEKNUMBER_OF_QUARTER(DATE '2022-05-01', 'ISO'),
WEEKNUMBER_OF_QUARTER(DATE '2022-07-06', 'ISO')

Ausgabe:

SELECT
PUBLIC.SUBSTR_UDF('Hello World!', -2);

Definition¶

Führt die gleiche Funktion aus wie die Teradata-FunktionNVP

NVP_UDF(INSTRING VARCHAR, NAME_TO_SEARCH VARCHAR, NAME_DELIMITERS VARCHAR, VALUE_DELIMITERS VARCHAR, OCCURRENCE FLOAT)

Parameter¶

INSTRING VARCHAR

Name-Wert-Paare sind Datenelemente, die aus einem Namen und dem dazugehörigen Wert bestehen.

NAME_TO_SEARCH vom Typ VARCHAR

Der Namensparameter, der für die Suche innerhalb der Name-Wert-Paar-Funktion (NVP) verwendet wird

NAME_DELIMITERS VARCHAR

Das Zeichen, das verwendet wird, um Namen von ihren entsprechenden Werten zu trennen

VALUE_DELIMITERS VARCHAR

Das Zeichen, das verwendet wird, um einen Namen mit seinem entsprechenden Wert zu verbinden

OCCURRENCE steht für eine Gleitkommazahl, die angibt, wie oft etwas vorkommt.

Die Anzahl der übereinstimmenden Muster, nach denen gesucht werden soll

Rückgabewerte¶

Eine Textzeichenfolge (VARCHAR), die die gleichen Daten enthält wie die Eingabezeichenfolge

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.NVP_UDF('entree=-orange chicken&entree+.honey salmon', 'entree', '&', '=- +.', 1);

Ausgabe:

orange chicken

Definition¶

Gibt den abgekürzten Namen eines Monats (drei Buchstaben) in Großbuchstaben, Kleinbuchstaben oder in Großbuchstaben Ihrer Wahl zurück: Beispiel: „Jan“, „jan“ oder „JAN“.

PUBLIC.MONTH_SHORT_UDF(INPUT TIMESTAMP_TZ, RESULTCASE VARCHAR)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datum in einem Format, in dem der abgekürzte Monatsname angezeigt wird

RESULTCASE VARCHAR

Das zu verwendende Großbuchstaben-/Kleinbuchstaben-Format. Gültige Optionen sind:

• ‚uppercase‘: Konvertiert Text in Großbuchstaben

• ‚lowercase‘: Konvertiert Text in Kleinbuchstaben

• ‚firstOnly‘: Schreibt nur den ersten Buchstaben groß

Rückgabewerte¶

Ein varchar mit dem abgekürzten Namen eines Monats (z. B. „Jan“, „Feb“ etc.).

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.MONTH_SHORT_UDF(DATE '2021-10-26', 'uppercase');
SELECT PUBLIC.MONTH_SHORT_UDF(DATE '2021-10-26', 'lowercase');
SELECT PUBLIC.MONTH_SHORT_UDF(DATE '2021-10-26', 'firstOnly');

Ausgabe:

OCT
oct
Oct

Definition¶

UDF (benutzerdefinierte Funktion), die einen Datumswert in seine numerische Darstellung konvertiert, ähnlich wie die Teradata-Funktion DATE-TO-NUMERIC

PUBLIC.DATE_TO_INT_UDF(DATE_TO_CONVERT DATE)

Parameter¶

DATE_TO_CONVERT steht für einen Datumswert, der umgewandelt werden muss

Konvertiert den Datumswert in ein Ganzzahlformat

Rückgabewerte¶

Gibt einen Datumswert im numerischen Format zurück

Beispiel¶

Eingabe:

SELECT mod(date '2015-11-26', 5890), sin(current_date);

CREATE TABLE SAMPLE_TABLE
(
    VARCHAR_TYPE VARCHAR,
    CHAR_TYPE CHAR(11),
    INTEGER_TYPE INTEGER,
    DATE_TYPE DATE,
    TIMESTAMP_TYPE TIMESTAMP,
    TIME_TYPE TIME,
    PERIOD_TYPE PERIOD(DATE)
);

REPLACE VIEW SAMPLE_VIEW
AS
SELECT
CAST(DATE_TYPE AS SMALLINT),
CAST(DATE_TYPE AS DECIMAL),
CAST(DATE_TYPE AS NUMBER),
CAST(DATE_TYPE AS FLOAT),
CAST(DATE_TYPE AS INTEGER)
FROM SAMPLE_TABLE;

Ausgabe:

SELECT
mod(PUBLIC.DATE_TO_INT_UDF(date '2015-11-26'), 5890),
sin(PUBLIC.DATE_TO_INT_UDF(CURRENT_DATE()));

CREATE TABLE PUBLIC.SAMPLE_TABLE
(
    VARCHAR_TYPE VARCHAR,
    CHAR_TYPE CHAR(11),
    INTEGER_TYPE INTEGER,
    DATE_TYPE DATE,
    TIMESTAMP_TYPE TIMESTAMP,
    TIME_TYPE TIME,
    PERIOD_TYPE VARCHAR(24) COMMENT 'PERIOD(DATE)' /*** MSC-WARNING - MSCEWI1036 - PERIOD DATA TYPE "PERIOD(DATE)" CONVERTED TO VARCHAR ***/
);

CREATE OR REPLACE VIEW PUBLIC.SAMPLE_VIEW
AS
SELECT
PUBLIC.DATE_TO_INT_UDF(DATE_TYPE),
PUBLIC.DATE_TO_INT_UDF(DATE_TYPE),
PUBLIC.DATE_TO_INT_UDF(DATE_TYPE),
PUBLIC.DATE_TO_INT_UDF(DATE_TYPE),
PUBLIC.DATE_TO_INT_UDF(DATE_TYPE)
FROM PUBLIC.SAMPLE_TABLE;

Definition¶

Eine benutzerdefinierte Funktion (UDF), die den P_INTERSECT-Operator repliziert. Diese Funktion vergleicht zwei oder mehr Zeiträume und stellt fest, wo sie sich überschneiden und gibt das gemeinsame Zeitintervall zwischen ihnen zurück.

Erzeugt eine Zeichenfolgendarstellung der Start- und Endwerte eines Zeitraums (TIMESTAMP stellt einen Datentyp dar, der sowohl Datums- als auch Uhrzeitinformationen speichert. TIME oder DATE ist ein Datentyp, der zum Speichern von Kalenderdaten (Jahr, Monat und Tag) ohne Uhrzeitinformationen verwendet wird.) Diese Funktion emuliert die Periodenwert-Konstruktorfunktion von Teradata. Die Ausgabezeichenfolge folgt dem Standardformat von Snowflake für PERIOD-Werte. Um die Genauigkeit der Ausgabe anzupassen, können Sie entweder:

• Den Sitzungsparameter timestamp_output_format ändern

• Die Drei-Parameter-Version dieser UDF verwenden

Weitere Einzelheiten über die Quellfunktion finden Sie in der Teradata-Dokumentation.

PERIOD_UDF(D1 TIMESTAMP_NTZ, D2 TIMESTAMP_NTZ)
PERIOD_UDF(D1 DATE, D2 DATE)
PERIOD_UDF(D1 TIME, D2 TIME)
PERIOD_UDF(D1 TIMESTAMP_NTZ, D2 TIMESTAMP_NTZ, PRECISIONDIGITS INT)
PERIOD_UDF(D1 TIME, D2 TIME, PRECISIONDIGITS INT)
PERIOD_UDF(D1 TIMESTAMP_NTZ)
PERIOD_UDF(D1 DATE)
PERIOD_UDF(D1 TIME)

Parameter¶

TIMESTAMP

Der Datentyp TimeStamp stellt einen bestimmten Zeitpunkt dar, der sowohl die Datums- als auch die Uhrzeitkomponente enthält.

TIME

Der Datentyp Time stellt eine bestimmte Tageszeit ohne eine Datumskomponente dar.

DATE

Der Datentyp Date stellt ein Kalenderdatum ohne Uhrzeitkomponente dar.

PRECISIONDIGITS gibt die Anzahl der Dezimalstellen an, die in numerischen Werten angezeigt werden sollen.

Die Anzahl der Ziffern, die im Uhrzeitformat angezeigt werden sollen

Rückgabewerte¶

Gibt eine Zeichenfolgendarstellung eines Wertes vom Typ PERIOD zurück

Verwendungsbeispiel¶

Eingabe:

SELECT
PERIOD_UDF('2005-02-03'),
PERIOD_UDF(date '2005-02-03'),
PERIOD_UDF(TIMESTAMP '2005-02-03 12:12:12.340000'),
PERIOD_UDF(TIMESTAMP '2005-02-03 12:12:12.340000');

Ausgabe:

2005-02-03*2005-02-04,
2005-02-03*2005-02-04,
2005-02-03 12:12:12.340000*2005-02-03 12:12:12.340001,
2005-02-03 12:12:12.340000*2005-02-03 12:12:12.340001

Definition¶

Gibt den vollständigen Namen eines Wochentags in Großbuchstaben, Kleinbuchstaben oder Großbuchstaben zurück (z. B. „MONDAYׅ“, „monday“ oder „Monday“).

PUBLIC.DAYNAME_LONG_UDF(INPUT TIMESTAMP_TZ, RESULTCASE VARCHAR)

Parameter¶

INPUT TIMESTAMP_TZ

Das Eingabedatum, aus dem der Wochentag ermittelt werden soll

RESULTCASE VARCHAR

Das erwartete Ergebnis oder Szenario, das demonstriert werden soll

Rückgabewerte¶

Gibt eine Zeichenfolge zurück, die den vollständigen Namen eines Wochentags enthält

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.DAYNAME_LONG_UDF(DATE '2021-10-26', 'uppercase');
SELECT PUBLIC.DAYNAME_LONG_UDF(DATE '2021-10-26', 'lowercase');
SELECT PUBLIC.DAYNAME_LONG_UDF(DATE '2021-10-26', 'firstOnly');

Ausgabe:

'TUESDAY'
'tuesday'
'Tuesday'

Definition¶

Verarbeitet einen Zeitstempel, um festzustellen, auf welchen Wochentag er fällt. Diese Funktion verhält sich identisch zu DAYNUMBER_OF_WEEK(DATE, 'COMPATIBLE').

PUBLIC.TD_DAY_OF_WEEK_COMPATIBLE_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Das Eingabedatum, das zur Bestimmung des Wochentags verwendet wird

Rückgabewerte¶

Gibt eine Zahl von 1 bis 7 zurück, die den Wochentag angibt, wobei 1 für den ersten Tag der Woche steht. Wenn der 1. Januar zum Beispiel auf einen Mittwoch fällt, dann ist Mittwoch = 1, Donnerstag = 2, Freitag = 3, Samstag = 4, Sonntag = 5, Montag = 6 und Dienstag = 7.

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.TD_DAY_OF_WEEK_COMPATIBLE_UDF(DATE '2022-01-01'),
PUBLIC.TD_DAY_OF_WEEK_COMPATIBLE_UDF(DATE '2023-05-05');

Ausgabe:

1, 6

Definition¶

Berechnet anhand des Jaro-Winkler-Algorithmus, wie ähnlich zwei Zeichenfolgen sind. Dieser Algorithmus vergibt eine Punktzahl zwischen 0 (völlig unterschiedlich) und 1 (identisch).

PUBLIC.JAROWINKLER_UDF (string1 VARCHAR, string2 VARCHAR)

Parameter¶

string1 vom Typ VARCHAR

Der zu verarbeitende Text

string2 vom Typ VARCHAR

Der zu verarbeitende Text

Rückgabewerte¶

Die Funktion gibt entweder 0 oder 1 zurück.

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.JAROWINKLER_UDF('święta', 'swieta')

Ausgabe:

0.770000

Definition¶

UDF, die den ersten Tag des ISO-Jahres für ein bestimmtes Datum berechnet. Sie ermittelt den Montag, der dem 1. Januar des Jahres am nächsten liegt, mit der Funktion DAYOFWEEKISO in Kombination mit PUBLIC.FIRST_DAY_JANUARY_OF_ISO_UDF. Die Funktion addiert oder subtrahiert Tage, um diesen Montag zu finden.

PUBLIC.YEAR_BEGIN_ISO_UDF(INPUT DATE)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datum, das den 1. Januar des laufenden Jahres nach dem ISO-Kalenderstandard darstellt

Rückgabewerte¶

Der erste Tag des Jahres nach dem ISO-Kalenderstandard

Verwendungsbeispiel¶

Eingabe:

SELECT  PUBLIC.YEAR_BEGIN_ISO_UDF(DATE '2022-01-01'),
PUBLIC.YEAR_BEGIN_ISO_UDF(DATE '2022-04-12');

Ausgabe:

2021-01-04, 2022-01-03

Definition¶

Extrahiert das Jahr aus einem Datum und kürzt es auf eine bestimmte Anzahl von Ziffern

PUBLIC.YEAR_PART_UDF(INPUT TIMESTAMP_TZ, DIGITS INTEGER)

Parameter¶

INPUT TIMESTAMP_TZ

Das Datum, aus dem das Jahr extrahiert werden soll

DIGITS: Eine ganze Zahl, die die maximale Anzahl der anzuzeigenden Ziffern angibt

Die Anzahl der gewünschten Dezimalstellen in der Ausgabe

Rückgabewerte¶

Extrahiert die Jahreskomponente aus einem angegebenen Datum

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.YEAR_PART_UDF(DATE '2021-10-26', 3);
SELECT PUBLIC.YEAR_PART_UDF(DATE '2021-10-26', 2);
SELECT PUBLIC.YEAR_PART_UDF(DATE '2021-10-26', 1);

Ausgabe:

'021'
'21'
'1'

Definition¶

Extrahiert das Jahr aus einem Datum und fügt ein Komma zwischen der ersten und zweiten Ziffer ein. Wenn das Jahr zum Beispiel 2023 ist, wird „2,023“ zurückgegeben.

PUBLIC.YEAR_WITH_COMMA_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Das Eingabedatum, aus dem das Jahr extrahiert werden soll

Rückgabewerte¶

Gibt den Jahresanteil eines Datumswertes als varchar (Text) mit einem Komma als Trennzeichen zurück

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.YEAR_WITH_COMMA_UDF(DATE '2021-10-26');

Ausgabe:

'2,021'

Definition¶

Berechnet die Anzahl der Monate zwischen zwei Daten

MONTHS_BETWEEN_UDF(FIRST_DATE TIMESTAMP_LTZ, SECOND_DATE TIMESTAMP_LTZ)

Parameter¶

FIRST_DATE ist eine Zeitstempelspalte, die sowohl Datums- als auch Uhrzeitinformationen enthält, mit Unterstützung der Zeitzone (TIMESTAMP_LTZ)

Das Anfangsdatum, ab dem die Funktion mit der Verarbeitung von Daten beginnt

SECOND_DATE TIMESTAMP_LTZ

Das Enddatum, das festlegt, wann die Zählung beendet wird

Rückgabewerte¶

Die Dauer in Monaten zwischen zwei Daten

Verwendungsbeispiel¶

Eingabe:

SELECT MONTHS_BETWEEN_UDF('2022-02-14', '2021-02-14');

Ausgabe:

12

Definition¶

Berechnet die Anzahl der seit Mitternacht verstrichenen Sekunden für eine bestimmte Uhrzeit

PUBLIC.SECONDS_PAST_MIDNIGHT_UDF(INPUT TIME)

Parameter¶

INPUT TIME

Die Funktion berechnet die Gesamtzahl der seit Mitternacht (00:00:00) bis zur aktuellen Uhrzeit verstrichenen Sekunden.

Rückgabewerte¶

Ein varchar-Wert, der die Anzahl der seit Mitternacht verstrichenen Sekunden angibt

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.SECONDS_PAST_MIDNIGHT_UDF(TIME'10:30:45');

Ausgabe:

'37845'

Definition¶

Gibt eine Zeichenfolge zurück, die die Hexadezimaldarstellung (base-16) jedes Zeichens in der Eingabezeichenfolge enthält

PUBLIC.CHAR2HEXINT_UDF(INPUT_STRING VARCHAR);

Parameter¶

INPUT_STRING ist eine Variable vom Typ VARCHAR, die Textdaten speichert.

Die Eingabezeichenfolge, die konvertiert werden muss

Rückgabewerte¶

Gibt eine Zeichenfolge zurück, die die Hexadezimaldarstellung der Eingabezeichenfolge enthält

Beispiel¶

Eingabe:

SELECT CHAR2HEXINT('1234') from t1;

Ausgabe:

SELECT
PUBLIC.CHAR2HEXINT_UDF('1234') from
t1;

Weitere Informationen aus der Quellfunktion¶

Die Funktionsdokumentation finden Sie in der Teradata-Dokumentation.

Definition¶

UDFs (benutzerdefinierte Funktionen), die Subtraktionsoperationen zwischen einem Intervallwert und einer Spaltenreferenz vom Typ Intervall verarbeiten

PUBLIC.INTERVAL_ADD_UDF
(INPUT_VALUE1 VARCHAR(), INPUT_PART1 VARCHAR(30), INPUT_VALUE2 VARCHAR(), INPUT_PART2 VARCHAR(30), OP CHAR, OUTPUT_PART VARCHAR())

Parameter¶

INPUT_VALUE1 vom Typ VARCHAR

Die Eingabedaten, die vom System verarbeitet werden sollen

INPUT_PART1 vom Typ VARCHAR

Die zu verwendende Zeiteinheit, z. B. HOUR

INPUT_VALUE2 ist ein Parameter vom Datentyp VARCHAR.

Der Name der referenzierten Spalte, z. B. INTERVAL_HOUR_TYPE

INPUT_PART2 VARCHAR

Der Datentyp, der der referenzierten Spalte zugewiesen wurde

OP-Zeichen

Das Symbol oder der Operator, das bzw. der gerade analysiert wird

OUTPUT_PART VARCHAR

Der Datentyp des zurückgegebenen Wertes

Rückgabewerte¶

Ein varchar-Wert, der das Ergebnis der Subtraktion zweier Zeitintervalle darstellt

Migrationsbeispiel¶

Eingabe:

CREATE TABLE INTERVAL_TABLE
(
    INTERVAL_YEAR_TYPE INTERVAL YEAR
);

SELECT INTERVAL_YEAR_TYPE - INTERVAL '7' MONTH FROM INTERVAL_TABLE;

Ausgabe:

CREATE OR REPLACE TABLE INTERVAL_TABLE
(
    INTERVAL_YEAR_TYPE VARCHAR(21) !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - INTERVAL YEAR DATA TYPE CONVERTED TO VARCHAR ***/!!!
)
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"teradata"}}'
;

SELECT
    PUBLIC.INTERVAL_ADD_UDF(INTERVAL_YEAR_TYPE, 'YEAR', '7', 'MONTH', '-', 'YEAR TO MONTH')
    FROM
    INTERVAL_TABLE;

Definition¶

Eine benutzerdefinierte Funktion (UDF), die einen Zeitstempel in den vollständigen Namen des Tages konvertiert (z. B. „Monday“, „Tuesday“ usw.)

PUBLIC.DAY_OF_WEEK_LONG_UDF(INPUT_DATE TIMESTAMP)

Parameter¶

INPUT_DATE stellt einen Zeitstempelwert dar.

Der Zeitstempel wird in einen vollständigen Tagesnamen konvertiert (z. B. „Monday“, „Tuesday“ usw.).

Rückgabewerte¶

Der Name des Tages auf Englisch.

Definition¶

Die benutzerdefinierte Funktion (UDF) dient als direkter Ersatz für die Teradaa-Funktion TD_WEEK_OF_CALENDAR und bietet dieselbe Funktionalität in Snowflake.

PUBLIC.TD_WEEK_OF_CALENDAR_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Datum zur Berechnung der Anzahl der Wochen, die seit dem 1. Januar 1900 verstrichen sind

Rückgabewerte¶

Eine Ganzzahl, die die Anzahl der vollständigen Wochen zwischen dem 1. Januar 1900 und dem angegebenen Datum angibt

Migrationsbeispiel¶

Eingabe:

SELECT TD_WEEK_OF_CALENDAR(DATE '2023-11-30')

Ausgabe:

SELECT
PUBLIC.TD_WEEK_OF_CALENDAR_UDF(DATE '2023-11-30');

Definition¶

Konvertiert negative Zahlen so, dass statt des Minuszeichens (-) spitze Klammern (< >) verwendet werden Diese Konvertierung erfolgt, wenn das Formatelement PR (Parentheses, Klammern) in der ursprünglichen Teradata-Formatzeichenfolge vorhanden ist.

PUBLIC.WRAP_NEGATIVE_WITH_ANGLE_BRACKETS_UDF(INPUT NUMBER, FORMATARG VARCHAR)

Parameter¶

INPUT ist ein numerischer Wert.

Der numerische Wert, der in eine Textzeichenfolge (varchar) umgewandelt wird

FORMATARG ist ein Parameter vom Typ VARCHAR, der das Format der Daten angibt.

Der Formatparameter gibt an, wie der INPUT-Wert in eine Textdarstellung (varchar) umgewandelt werden soll.

Rückgabewerte¶

Ein varchar mit negativen Zahlen in spitzen Klammern (< >)

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.WRAP_NEGATIVE_WITH_ANGLE_BRACKETS_UDF(8456, '9999');
SELECT PUBLIC.WRAP_NEGATIVE_WITH_ANGLE_BRACKETS_UDF(-8456, '9999');

Ausgabe:

'8456'
'<8456>'

Definition¶

Sucht alle Instanzen, in denen „search_string“ im „source_string“ vorkommt.

PUBLIC.INSTR_UDF(SOURCE_STRING STRING, SEARCH_STRING STRING)

Parameter¶

SOURCE_STRING steht für die Eingabezeichenfolge, die verarbeitet werden muss.

Der Text, der gesucht werden soll

SEARCH_STRING ist ein Parameter vom Typ STRING, der den Text angibt, nach dem gesucht werden soll.

Das Textmuster, das die Funktion sucht und vergleicht

Rückgabewerte¶

Die Indexposition, an der das Muster in der Quellzeichenfolge gefunden wird (beginnend an Position 1)

Verwendungsbeispiel¶

Eingabe:

SELECT INSTR_UDF('INSTR FUNCTION','N');

Ausgabe:

2

Definition¶

Überprüft, ob der Code erfolgreich konvertiert werden kann, ohne Fehler zu erzeugen

PUBLIC.TRANSLATE_CHK_UDF(COL_NAME STRING, SOURCE_REPERTOIRE_NAME STRING)

Parameter¶

COL_NAME ist eine Zeichenfolgenvariable, die einen Spaltennamen darstellt.

Die Spalte, die validiert werden muss.

SOURCE_REPERTOIRE_NAME ist ein Zeichenfolgenparameter, der den Namen des Quellverzeichnisses angibt.

Der Name der Quellsammlung oder -bibliothek

Rückgabewerte¶

0: Die Übersetzung war erfolgreich und wurde ohne Fehler abgeschlossen. NULL: Es wurde kein Ergebnis zurückgegeben (Nullwert).

Die Position des ersten Zeichens in der Zeichenfolge verursacht einen Übersetzungsfehler.

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.TRANSLATE_CHK_UDF('ABC', 'UNICODE_TO_LATIN');

Ausgabe:

0

Definition¶

Repliziert das Verhalten der EXPAND-ON-Funktion von Teradata.

PUBLIC.EXPAND_ON_UDF(TIME STRING, SEQ NUMBER, PERIOD STRING)

Parameter¶

TIME ist ein Datentyp, der Uhrzeitwerte als Text (STRING) speichert.

Die Zeit, die der Anker für die vollständige Erweiterung benötigt

SEQ: Sequenznummer

Die Reihenfolge, in der die Werte der einzelnen Zeilen berechnet werden

PERIOD: Ein Textwert, der einen Zeitraum darstellt

Das Datum des angegebenen Zeitraums

Rückgabewerte¶

Ein VARCHAR-Wert, der definiert, wie der Erweiterungszeitraum in der EXPAND-ON-Klausel berechnet werden soll

Migrationsbeispiel¶

Eingabe:

SELECT bg FROM table1 EXPAND ON pd AS bg BY ANCHOR ANCHOR_SECOND;

Ausgabe:

WITH
ExpandOnCTE AS
(
SELECT
PUBLIC.EXPAND_ON_UDF('ANCHOR_SECOND', VALUE, pd) bg
FROM
table1,
TABLE(FLATTEN(PUBLIC.ROW_COUNT_UDF(PUBLIC.DIFF_TIME_PERIOD_UDF('ANCHOR_SECOND', pd))))
)
SELECT
bg
FROM
table1,
ExpandOnCTE;

Definition¶

Gibt ein Array zurück, das fortlaufende Nummern von 1 bis zu dem von DIFF_TIME_PERIOD_UDF zurückgegebenen Wert enthält

PUBLIC.ROW_COUNT_UDF(NROWS DOUBLE)

Parameter¶

NROWS stellt die Gesamtzahl der Zeilen in einem Datenset als Dezimalzahl dar (DOUBLE).

Der von der Funktion DIFF_TIME_PERIOD_UDF zurückgegebene Wert

Rückgabewerte¶

Ein Array, das die Anzahl der Zeilen bestimmt, die erforderlich sind, um die Funktionalität der EXPAND ON-Klausel zu replizieren

Verwendungsbeispiel¶

Eingabe:

SELECT ROW_COUNT_UDF(DIFFTTIME_PERIOD('SECONDS','2022-11-26 10:15:20.000*2022-11-26 10:15:25.000'));

Ausgabe:

[1, 2, 3, 4, 5]

Migrationsbeispiel¶

Eingabe:

SELECT NORMALIZE emp_id, duration FROM project EXPAND ON duration AS bg BY ANCHOR ANCHOR_SECOND;

Ausgabe:

WITH ExpandOnCTE AS
(
SELECT
    PUBLIC.EXPAND_ON_UDF('ANCHOR_SECOND', VALUE, duration) bg
FROM
    project,
TABLE(FLATTEN(PUBLIC.ROW_COUNT_UDF(PUBLIC.DIFF_TIME_PERIOD_UDF('ANCHOR_SECOND', duration))))
)
SELECT NORMALIZE emp_id,
    duration
FROM
    project,
    ExpandOnCTE;

Definition¶

Berechnet das Jahrhundert für ein bestimmtes Datum

PUBLIC.CENTURY_UDF(INPUT TIMESTAMP_TZ)

Parameter¶

INPUT TIMESTAMP_TZ

Das Eingabedatum, das zur Bestimmung des Jahrhunderts verwendet wird

Rückgabewerte¶

Gibt die Jahrhundertzahl als varchar für ein bestimmtes Datum zurück

Verwendungsbeispiel¶

Eingabe:

SELECT PUBLIC.CENTURY_UDF(DATE '1915-02-23');

Ausgabe:

'20'

Definition¶

Berechnet das Zeitintervall zwischen zwei angegebenen Zeitstempeln