Są dostępne różne typy funkcji, których można używać w wyrażeniach.
Tematy:
Funkcje analityczne umożliwiają eksplorację danych przy użyciu modeli takich jak prognoza, linia trendu i klaster. Alternatywnie można przeciągać i upuszczać funkcje analityczne do edytora skoroszytu.
Alternatywnie do skoroszytu można dodawać prognozy, linie trendów i klastry, wybierając je na karcie "Analizy" panelu "Dane" w edytorze skoroszytu. Zob. Dodawanie funkcji analiz statystycznych do wizualizacji.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
CLUSTER |
|
Ta funkcja rozdziela zbiór rekordów na grupy na podstawie jednego lub większej liczby wyrażeń wejściowych, używając algorytmu centroidów (K-Means) lub klasteryzacji hierarchicznej (metody Czekanowskiego). |
|
FORECAST |
Przykład prognozy przychodów wg dnia W tym przykładzie jest wybierana prognoza przychodów wg dnia. FORECAST("A - Sample Sales"."Base Facts"."1- Revenue" Target, ("A - Sample Sales"."Time"."T00 Calendar Date"),'forecast', 'numPeriods=30;predictionInterval=70;') ForecastedRevenue Przykład prognozy przychodów wg roku i kwartału W tym przykładzie jest wybierana prognoza przychodów wg roku i kwartału. FORECAST("A - Sample Sales"."Base Facts"."1- Revenue", ("A - Sample Sales"."Time"."T01 Year" timeYear, "A - Sample Sales"."Time"."T02 Quarter" TimeQuarter),'forecast', 'numPeriods=30;predictionInterval=70;') ForecastedRevenue |
Tworzy model szeregów czasowych dla określonej miary na podstawie serii, używając algorytmu "ETS (wygładzanie wykładnicze)", "Sezonowa ARIMA", "ARIMA" lub "Prophet". Wynikiem tej funkcji jest prognoza dla zestawu okresów określonego za pomocą argumentu numPeriods. Zob. także dodatkowe opcje funkcji FORECAST poniżej. |
FORECAST(measure, ([series]), output_column_name, options,[runtime_binded_options])])
Gdzie:
Zob. także dodatkowe opcje funkcji FORECAST poniżej. |
OUTLIER |
|
Klasyfikuje rekord jako odstający na podstawie jednego lub większej liczby wyrażeń wejściowych, używając algorytmu centroidów (K-Means), klasteryzacji hierarchicznej (metody Czekanowskiego) lub wieloczynnikowego wykrywania odstających. |
|
REGR |
|
Dopasowuje model liniowy i zwraca dopasowane wartości lub model. Tej funkcji można użyć w celu dopasowania krzywej liniowej do dwóch miar. |
|
TRENDLINE |
|
Oracle zaleca stosowanie funkcji TRENDLINE za pomocą właściwości Dodaj statystyki podczas wyświetlania wizualizacji. Zob. Dostosowywanie właściwości wizualizacji. Dopasowuje model liniowy, wielomianowy lub wykładniczy i zwraca dopasowane wartości lub model. numeric_expr reprezentuje wartość Y dla trendu, a series (kolumny czasu) reprezentują wartość X. |
|
Opcje funkcji FORECAST W poniższej tabeli są przedstawione opcje, których można używać z funkcją FORECAST
.
Nazwa opcji | Wartości | Opis |
---|---|---|
numPeriods | Liczba całkowita | Liczba prognozowanych okresów. |
predictionInterval | Od 0 do 100, przy czym większe wartości oznaczają większą ufność. | Poziom ufności predykcji. |
modelType |
ETS (wygładzanie wykładnicze) SeasonalArima ARIMA Prophet |
Model używany do prognozowania. |
useBoxCox |
TRUE FALSE |
Jeśli TRUE, jest używana transformacja Boxa-Coxa. |
lambdaValue | Nie dotyczy |
Parametr transformacji Boxa-Coxa Pomijany dla wartości NULL lub gdy W przeciwnym razie dane są przekształcane przed zastosowaniem modelu. |
trendDamp |
TRUE FALSE |
Jest to opcja specyficzna dla modelu "Wygładzanie wykładnicze". Jeśli TRUE, jest używany trend gasnący. Jeśli FALSE lub NULL, jest używany trend niegasnący. |
errorType |
Nie dotyczy |
Jest to opcja specyficzna dla modelu "Wygładzanie wykładnicze". |
trendType |
N (brak) A (addytywny) M (multiplikatywny) Z (automatycznie wybierany) |
Jest to opcja specyficzna dla modelu "Wygładzanie wykładnicze" |
seasonType |
N (brak) A (addytywny) M (multiplikatywny) Z (automatycznie wybierany) |
Jest to opcja specyficzna dla modelu "Wygładzanie wykładnicze" |
modelParamIC |
ic_auto ic_aicc ic_bic ic_auto (wartość domyślna) |
Kryterium informacyjne (IC) używane przy wyborze modelu. |
Funkcje konwertujące przekształcają wartość z jednej postaci w inną.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
CAST |
|
Zmienia typ danych wyrażenia lub literał Null na inny typ danych. Na przykład można rzutować customer_name (typ danych Do zmiany typu danych na typ "data" (Date) należy używać funkcji Nie używać w tym celu funkcji |
|
IFNULL |
|
Testuje, czy wynikiem wyrażenia jest wartość Null, a jeśli tak, to przypisuje wynikowi wyrażenia określoną wartość. |
|
INDEXCOL |
|
Wykorzystując zewnętrzne informacje (np. wartość zmiennej), zwraca odpowiednią kolumnę dla zalogowanego użytkownika. |
|
NULLIF |
|
Porównuje dwa wyrażenia. Jeśli ich wartości są równe, funkcja zwraca NULL. Jeśli ich wartości nie są równe, funkcja zwraca wartość pierwszego wyrażenia. Jako pierwszego wyrażenia nie można podać literału NULL. |
|
To_DateTime |
|
Konwertuje literały napisowe w formacie daty-godziny (DateTime) na typ danych DateTime. |
|
VALUEOF |
|
Odwołuje się w filtrze do wartości zmiennej modelu semantycznego. Jako argumentów funkcji |
|
Funkcje te obliczają lub zaokrąglają wartości znaczników czasu do najbliższego określonego okresu, takiego jak godzina, dzień, tydzień, miesiąc i kwartał.
Obliczonych znaczników czasu można używać do agregacji danych z różną szczegółowością. Na przykład można zastosować funkcję EXTRACTDAY()
do dat zamówień sprzedaży, aby obliczyć znacznik czasu jako północ dnia złożenia zamówienia i agregować dane wg dnia.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
Ekstrakcja dnia |
EXTRACTDAY("Order Date")
|
Zwraca znacznik czasu dla północy (12 AM) w dniu, w którym pojawia się wartość wejściowa. Na przykład, jeśli znacznikiem czasu wartości wejściowej jest 3:02:01 AM w dniu 22 lutego, to funkcja zwraca znacznik czasu 12:00:00 AM w dniu 22 lutego. |
|
Ekstrakcja godziny |
EXTRACTHOUR("Order Date")
|
Zwraca znacznik czasu dla początku godziny, o której pojawia się wartość wejściowa. Na przykład, jeśli znacznikiem czasu wartości wejściowej jest 11:18:30 PM, to funkcja zwraca znacznik czasu 11:00:00 PM. |
|
Ekstrakcja godziny dnia |
EXTRACTHOUROFDAY("Order Date")
|
Zwraca znacznik czasu, w którym godzina równa się godzinie wartości wejściowej i są używane wartości domyślne dla roku, miesiąca, dnia, minut i sekund. |
|
Ekstrakcja milisekund |
EXTRACTMILLISECOND("Order Date")
|
Zwraca znacznik czasu dla wartości wejściowej zawierający milisekundy. Na przykład, jeśli znacznikiem czasu wartości wejściowej jest 15:32:02.150, to funkcja zwraca znacznik czasu 15:32:02.150. |
|
Ekstrakcja minut |
EXTRACTMINUTE("Order Date")
|
Zwraca znacznik czasu dla początku minuty, o której pojawia się wartość wejściowa. Na przykład, jeśli znacznikiem czasu wartości wejściowej jest 11:38:21 AM, to funkcja zwraca znacznik czasu 11:38:00 AM. |
|
Ekstrakcja miesiąca |
EXTRACTMONTH("Order Date")
|
Zwraca znacznik czasu dla pierwszego dnia miesiąca, w którym pojawia się wartość wejściowa. Na przykład, jeśli znacznik czasu wartości wejściowej zawiera 22 lutego, to funkcja zwraca znacznik czasu 1 lutego. |
|
Ekstrakcja kwartału |
EXTRACTQUARTER("Order Date")
|
Zwraca znacznik czasu dla pierwszego dnia tygodnia, w którym pojawia się wartość wejściowa. Na przykład, jeśli znacznik czasu wartości wejściowej występuje w trzecim kwartale obrotowym, to funkcja zwraca znacznik czasu 1 lipca. |
|
Ekstrakcja sekund |
EXTRACTSECOND("Order Date")
|
Zwraca znacznik czasu dla wartości wejściowej. Na przykład, jeśli znacznikiem czasu wartości wejściowej jest 15:32:02.150, to funkcja zwraca znacznik czasu 15:32:02. |
|
Ekstrakcja tygodnia |
EXTRACTWEEK("Order Date")
|
Zwraca datę pierwszego dnia tygodnia (niedziela), w którym pojawia się wartość wejściowa. Na przykład, jeśli znacznik czasu wartości wejściowej zawiera środę, 24 września,, to funkcja zwraca znacznik czasu dla niedzieli, 21 września. Uwaga: jeśli pierwszy dzień tygodnia (np. niedziela) wypada w poprzednim roku, co miałoby odwrotny wpływ na agregację, funkcja zwraca siódmy dzień tygodnia (np. sobota) w bieżącym roku, zamiast pierwszego dnia tygodnia w poprzednim roku. Na przykład wynikiem agregacji dat 1/1/24, 1/2/24 i 1/3/24 będzie sobota 1/6/24, a nie niedziela 12/29/23. |
|
Ekstrakcja roku |
EXTRACTYEAR("Order Date")
|
Zwraca znacznik czasu dla 1 stycznia roku, w którym pojawia się wartość wejściowa. Na przykład, jeśli znacznik czasu wartości wejściowej występuje w roku 1967, to funkcja zwraca znacznik czasu 1 stycznia 1967. |
|
Poniżej przedstawiono kilka porad na temat tego, jak uzyskać najlepsze wyniki podczas używania dat obszarów tematycznych w obliczeniach.
Dodawanie daty obszaru tematycznego do obliczenia
Jeśli data zostanie przeciągnięta z obszaru tematycznego bezpośrednio do obliczenia, a następnie będzie przetwarzana jako napis lub liczba całkowita, wystąpi błąd. Dzieje się tak, ponieważ faktyczna wartość daty jest znacznikiem czasu.
Zamiast tego należy w celu zinterpretowania daty użyć jednej z funkcji opisanych na stronie Funkcje ekstrakcji daty.
Na przykład można chcieć użyć następujących dat obszarów tematycznych.
.png"
Aby wyodrębnić miesiące z tych dat obszarów tematycznych, należy użyć funkcji ExtractMonthOfYear:
case when monthname(ExtractMonthOfYear("Date")) in ('Jan' ,'Feb', 'Mar') THEN 'Q1' ELSE 'Rest of the year' END
Funkcje wyświetlania operują na zbiorze wyników wyświetlania.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
BottomN |
|
Zwraca n najmniejszych wartości wyrażenia, sklasyfikowanych od najmniejszej do największej. |
|
FILTER |
|
Oblicza wyrażenie z użyciem podanego filtra wstępnej agregacji. |
|
MAVG |
|
Oblicza średnią ruchomą dla ostatnich n wierszy danych w zbiorze wyników, włącznie z wierszem bieżącym. |
|
MSUM |
|
Oblicza sumę ruchomą dla ostatnich n wierszy danych, włącznie z wierszem bieżącym. Suma dla pierwszego wiersza jest równa wartości wyrażenia liczbowego dla pierwszego wiersza. Suma dla drugiego wiersza jest obliczana jako suma pierwszych dwóch wierszy danych itd. Gdy zostanie osiągnięty n-ty wiersz, suma jest obliczana na podstawie n ostatnich wierszy danych. |
|
NTILE |
|
Ustala klasyfikację wartości z użyciem przedziału określonego przez użytkownika. Zwraca liczby całkowite reprezentujące dowolny zakres klasyfikacji. Ten przykład pokazuje przedział od 1 do 100, z najmniejszą wartością sprzedaży = 1 i największą = 100. |
|
PERCENTILE |
|
Oblicza klasyfikację centylową dla każdej wartości odpowiadającej argumentowi mającemu postać wyrażenia liczbowego. Przedział klasyfikacji centylowych zawiera się od 0 (pierwszy centyl) do 1 (setny centyl) włącznie. |
|
RANK |
|
Oblicza klasyfikację poszczególnych wartości odpowiadających argumentowi wyrażenia liczbowego. Największej liczbie jest przypisywana pozycja 1, a każdej kolejnej pozycji jest przypisywana następna liczba całkowita (2, 3, 4, ...). Jeśli jakieś wartości są jednakowe, to jest im przypisywana ta sama pozycja (np. 1, 1, 1, 4, 5, 5, 7 ...). |
|
RCOUNT |
|
Przyjmuje jako wejście zbiór rekordów i zlicza liczbę rekordów napotkanych do danego momentu. |
|
RMAX |
|
Przyjmuje jako wejście zbiór rekordów i pokazuje maksymalną wartość na podstawie rekordów napotkanych do danego momentu. Podany typ danych musi być jednym z tych, które można uporządkować. |
|
RMIN |
|
Przyjmuje jako wejście zbiór rekordów i pokazuje minimalną wartość na podstawie rekordów napotkanych do danego momentu. Podany typ danych musi być jednym z tych, które można uporządkować. |
|
RSUM |
|
Oblicza sumę kumulacyjną opartą na rekordach napotkanych do danego momentu. Suma dla pierwszego wiersza jest równa wartości wyrażenia liczbowego dla pierwszego wiersza. Suma dla drugiego wiersza jest obliczana jako suma pierwszych dwóch wierszy danych itd. |
|
TOPN |
|
Zwraca n największych wartości wyrażenia, sklasyfikowanych od największej do najmniejszej. |
|
Wskazówki dotyczące korzystania z funkcji wyświetlania
filter (<measure> using fiscal_quarter = 'Q4')
filter (<measure> using fiscal_quarter = 'Q3')
filter (<measure> using fiscal_year = 'FY24')
Funkcje ewaluacji to funkcje bazy danych, których (funkcji) można użyć do przekazywania wyrażeń w celu uzyskania zaawansowanych obliczeń.
Osadzane funkcje bazy danych mogą wymagać jednej lub więcej kolumn. Funkcja odwołuje się do tych kolumn za pomocą argumentów %1 ... %N. Faktyczne kolumny muszą zostać wyszczególnione po funkcji.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
EVALUATE |
|
Przekazuje podaną funkcję bazy danych, wraz z opcjonalnymi kolumnami (jako parametrami), do bazy danych w celu obliczenia. |
|
EVALUATE_AGGR |
|
Przekazuje podaną funkcję bazy danych, wraz z opcjonalnymi kolumnami (jako parametrami), do bazy danych w celu obliczenia. Ta funkcja jest przeznaczona dla funkcji agregacji z klauzulą |
|
Opisane tu funkcje matematyczne służą do wykonywania działań matematycznych.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
ABS |
|
Oblicza wartość bezwzględną wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
ACOS |
|
Oblicza arcus cosinus wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
ASIN |
|
Oblicza arcus sinus wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
ATAN |
|
Oblicza arcus tangens wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
ATAN2 |
|
Oblicza arcus tangens wyrażenia y /x, gdzie y jest pierwszym wyrażeniem liczbowym, a x jest drugim wyrażeniem liczbowym. |
|
CEILING |
|
Zaokrągla niecałkowitoliczbowe wyrażenie do następnej największej liczby całkowitej. Jeśli wynikiem wyrażenia liczbowego jest liczba całkowita, to funkcja |
|
COS |
|
Oblicza cosinus wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
COT |
|
Oblicza cotangens wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
DEGREES |
|
Przekształca wartość wyrażenia z radianów na stopnie. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
EXP |
|
Podnosi wartość do podanej potęgi. Oblicza e podniesione do potęgi n, gdzie e jest podstawą logarytmu naturalnego. |
|
ExtractBit |
|
Pobiera bit z określonego miejsca w liczbie całkowitej. Zwraca liczbę całkowitą 0 lub 1 odpowiadającą wartości bitu w tym miejscu. |
|
FLOOR |
|
Zaokrągla wyrażenie niecałkowitoliczbowe do najbliższej najmniejszej liczby całkowitej. Jeśli wynikiem wyrażenia liczbowego jest liczba całkowita, to funkcja |
FLOOR(expr) |
LOG |
|
Oblicza logarytm naturalny wartości wyrażenia. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
LOG10 |
|
Oblicza logarytm dziesiętny wartości wyrażenia. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
MOD |
|
Dzieli pierwsze wyrażenie liczbowe przez drugie wyrażenie liczbowe i zwraca resztę z dzielenia. |
|
PI |
|
Zwraca wartość (stałą) liczby pi. |
|
POWER |
|
Podnosi pierwsze wyrażenie liczbowe do potęgi określonej przez drugie wyrażenie liczbowe. |
|
RADIANS |
|
Przekształca wartość wyrażenia ze stopni na radiany. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
RAND |
|
Zwraca liczbę pseudolosową z przedziału od 0 do 1. |
|
RANDFromSeed |
|
Zwraca liczbę pseudolosową na podstawie podanej wartości inicjalizującej. Dla danej wartości inicjalizującej jest generowany ten sam zbiór liczb losowych. |
|
ROUND |
|
Zaokrągla wyrażenie liczbowe z dokładnością do n cyfr. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. integer jest dowolną dodatnią liczbą całkowitą określającą liczbę cyfr precyzji. |
|
SIGN |
|
Zwraca:
|
|
SIN |
|
Oblicza sinus wyrażenia liczbowego. |
|
SQRT |
|
Oblicza pierwiastek kwadratowy z wyrażenia liczbowego będącego argumentem. Wartością wyrażenia liczbowego musi być liczba nieujemna. |
|
TAN |
|
Oblicza tangens wyrażenia liczbowego. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
TRUNCATE |
|
Przycina liczbę dziesiętną, zwracając określoną liczbę miejsc po separatorze części dziesiętnej. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. integer jest dowolną dodatnią liczbą całkowitą reprezentującą zwracaną liczbę znaków, z prawej strony separatora części dziesiętnej. |
|
Funkcje agregacji kumulacyjnej wykonują operacje na wielu wartościach w celu uzyskania wyników podsumowujących.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
MAVG |
Oblicza średnią ruchomą dla ostatnich n wierszy danych w zbiorze wyników, włącznie z wierszem bieżącym. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. integer jest dowolną dodatnią liczbą całkowitą. Reprezentuje średnią z ostatnich n wierszy danych. |
|
|
MSUM |
|
Oblicza sumę ruchomą dla ostatnich n wierszy danych, włącznie z wierszem bieżącym. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. integer jest dowolną dodatnią liczbą całkowitą. Reprezentuje sumę z ostatnich n wierszy danych. |
|
RSUM |
|
Oblicza sumę kumulacyjną opartą na rekordach napotkanych do danego momentu. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową. |
|
RCOUNT |
|
Przyjmuje jako wejście zbiór rekordów i zlicza liczbę rekordów napotkanych do danego momentu. expr jest wyrażeniem o dowolnym typie danych. |
|
RMAX |
|
Przyjmuje jako wejście zbiór rekordów i pokazuje maksymalną wartość na podstawie rekordów napotkanych do danego momentu. expr jest wyrażeniem o dowolnym typie danych. |
|
RMIN |
|
Przyjmuje jako wejście zbiór rekordów i pokazuje minimalną wartość na podstawie rekordów napotkanych do danego momentu. expr jest wyrażeniem o dowolnym typie danych. |
|
Funkcje przestrzenne umożliwiają wykonywanie analiz geograficznych podczas modelowania danych. Na przykład można obliczyć odległość między dwoma obszarami geograficznymi, określanymi jako kształty (shape) lub wielokąty (polygon).
Uwaga:
Tych funkcji przestrzennych nie można używać w niestandardowych obliczeniach dla skoroszytów wizualizacji.Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
GeometryArea |
|
Oblicza obszar zajmowany przez kształt. |
|
GeometryDistance |
|
Oblicza odległość między dwoma kształtami. |
|
GeometryLength |
|
Oblicza obwód kształtu. |
|
GeometryRelate |
|
Ustala, czy jeden kształt zawiera się w drugim. Zwraca wartość napisową (varchar) "TRUE" lub "FALSE". |
|
GeometryWithinDistance |
|
Ustala, czy odległość między dwoma kształtami zawiera się w określonej wartości. Zwraca wartość napisową (varchar) "TRUE" lub "FALSE". |
|
Funkcje napisowe umożliwiają wykonywanie różnych operacji na napisach. Operują na wartościach napisowych.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
ASCII |
|
Przekształca jednoznakowy napis w odpowiadający mu kod ASCII (od 0 do 255). Jeśli wynikiem wyrażenia znakowego będzie więcej niż jeden znak, to zostanie zwrócony kod ASCII odpowiadający pierwszemu znakowi. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
BIT_LENGTH |
|
Zwraca długość podanego napisu wyrażoną w bitach. Każdy znak Unicode składa się z dwóch bajtów, czyli z 16 bitów. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
CHAR |
|
Przekształca wartość liczbową z przedziału od 0 do 255 w znak odpowiadający podanemu kodowi ASCII. expr jest dowolnym wyrażeniem dającym w wyniku wartość liczbową z przedziału od 0 do 255. |
|
CHAR_LENGTH |
|
Zwraca długość podanego napisu wyrażoną liczbą znaków. Przy ustalaniu długości nie są uwzględniane początkowe ani końcowe spacje. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
CONCAT |
|
Łączy dwa napisy. expr są rozdzielonymi przecinkiem wyrażeniami dającymi w wyniku napis. Z funkcją |
|
INSERT |
|
Wstawia podany napis w określone miejsce w drugim napisie. expr1 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje docelowy napis. integer1 jest dowolną dodatnią liczbą całkowitą reprezentującą liczbę znaków liczoną od początku napisu, określającą miejsce, w którym ma zostać wstawiony drugi napis. integer2 jest dowolną dodatnią liczbą całkowitą reprezentującą liczbę znaków w napisie docelowym, która ma zostać zastąpiona przez drugi napis. expr2 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje napis, który ma zostać wstawiony do docelowego napisu. |
|
LEFT |
|
Zwraca określoną liczbę początkowych znaków napisu (z lewej strony). expr jest dowolnym wyrażeniem dającym w wyniku napis integer jest dowolną dodatnią liczbą całkowitą reprezentującą zwracaną liczbę znaków, liczoną od początku (od lewej strony) napisu. |
|
LENGTH |
|
Zwraca długość podanego napisu wyrażoną liczbą znaków. Pomijane są wszystkie końcowe znaki puste. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
LOCATE |
|
Zwraca wartość określającą liczbowo pozycję napisu w innym napisie. Jeśli szukany napis nie zostanie znaleziony w przeszukiwanym napisie, to zostanie zwrócona wartość 0 (zero). expr1 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje szukany napis. expr2 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje przeszukiwany napis. |
|
LOCATEN |
|
Podobnie jak LOCATE, zwraca wartość określającą liczbowo pozycję napisu w innym napisie. LOCATEN zawiera argument będący liczbą całkowitą, za pomocą którego można określić pozycję, od której ma się rozpocząć wyszukiwanie. expr1 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje szukany napis. expr2 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje przeszukiwany napis. integer jest dowolną dodatnią (niezerową) liczbą całkowitą reprezentującą pozycję, od której ma zostać rozpoczęte wyszukiwanie napisu. |
|
LOWER |
|
Przekształca litery napisu na małe. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
OCTET_LENGTH |
|
Zwraca długość podanego napisu wyrażoną w bajtach. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
POSITION |
|
Zwraca wartość określającą liczbowo pozycję wyrażenia strExpr1 w wyrażeniu znakowym. Jeśli strExpr1 nie zostanie znalezione, zostanie zwrócona wartość 0 (zero). expr1 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje napis szukany w napisie docelowym. Na przykład "d". expr2 jest dowolnym wyrażeniem dającym w wyniku napis. Identyfikuje przeszukiwany napis docelowy. Na przykład "abcdef". |
|
REPEAT |
|
Powtarza podane wyrażenie n razy. expr jest dowolnym wyrażeniem dającym w wyniku napis integer jest dowolną dodatnią (niezerową) liczbą całkowitą reprezentującą liczbę powtórzeń napisu. |
|
REPLACE |
|
Zastępuje jeden lub więcej znaków z podanego wyrażenia liczbowego jednym lub większą liczbą innych znaków. expr1 jest dowolnym wyrażeniem dającym w wyniku napis. Jest to napis, w którym mają zostać zastąpione znaki. expr2 jest dowolnym wyrażeniem dającym w wyniku napis. Ten drugi napis identyfikuje znaki z pierwszego napisu, które mają zostać zastąpione. expr3 jest dowolnym wyrażeniem dającym w wyniku napis. Ten trzeci napis określa znaki, którymi mają zostać zastąpione znaki w pierwszym napisie. |
|
RIGHT |
|
Zwraca określoną liczbę końcowych znaków napisów (z prawej strony). expr jest dowolnym wyrażeniem dającym w wyniku napis. integer jest dowolną dodatnią liczbą całkowitą reprezentującą zwracaną liczbę znaków, liczoną od końca (od prawej strony) napisu. |
|
SPACE |
|
Wstawia spacje. integer jest dowolną dodatnią liczbą całkowitą określającą liczbę wstawianych spacji. |
|
SUBSTRING |
|
Tworzy nowy napis, zaczynając od określonej pozycji początkowej w napisie pierwotnym. expr jest dowolnym wyrażeniem dającym w wyniku napis. startPos jest dowolną dodatnią liczbą całkowitą reprezentującą liczbę znaków liczoną od początku napisu, określającą miejsce, w którym rozpoczyna się napis wynikowy. |
|
SUBSTRINGN |
|
Podobnie jak SUBSTRING, tworzy nowy napis, zaczynając od określonej pozycji początkowej w napisie pierwotnym. SUBSTRINGN zawiera argument będący liczbą całkowitą, za pomocą którego można długość nowego napisu, wyrażoną w znakach. expr jest dowolnym wyrażeniem dającym w wyniku napis. startPos jest dowolną dodatnią liczbą całkowitą reprezentującą liczbę znaków liczoną od początku napisu, określającą miejsce, w którym rozpoczyna się napis wynikowy. |
|
TrimBoth |
|
Usuwa z napisu podane początkowe i końcowe znaki. char jest dowolnym znakiem. Jeśli ta specyfikacja zostanie pominięta (i wymagane apostrofy), zostanie domyślnie użyta spacja. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
TRIMLEADING |
|
Usuwa z napisu podane początkowe znaki. char jest dowolnym znakiem. Jeśli ta specyfikacja zostanie pominięta (i wymagane apostrofy), zostanie domyślnie użyta spacja. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
TRIMTRAILING |
|
Usuwa z napisu podane końcowe znaki. char jest dowolnym znakiem. Jeśli ta specyfikacja zostanie pominięta (i wymagane apostrofy), zostanie domyślnie użyta spacja. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
UPPER |
|
Przekształca litery napisu na wielkie. expr jest dowolnym wyrażeniem dającym w wyniku napis. |
|
Oto kilka wskazówek dotyczących używania funkcji LISTAGG, które pomogą uzyskać najlepsze wyniki w zakresie obsługi napisów w skoroszytach. Na przykład można utworzyć napis zawierający wszystkie miasta z kolumny danych.
Konkatenacja wielu wartości:
Funkcja LISTAGG umożliwia połączenie wielu wartości w jedną komórkę i jeden wiersz.
LISTAGG([DISTINCT] <column to concatenate> BY <grouping column>) ON OVERFLOW TRUNCATE
DISTINCT
- jeśli wartości nie są unikatowe, należy użyć tego argumentu w celu usunięcia zduplikowanych wartości.ON OVERFLOW TRUNCATE
- jeśli wynik przekracza maksymalną dozwoloną długość, należy użyć tego argumentu w celu obcięcia zwracanego napisu.Number City State 12 New York New York 14 New York New York 30 Boston Massachusetts 18 Salem Massachusetts 12 Buffalo New York 10 Buffalo New York 20 Albany New York
Przykładowe polecenia i wyniki
LISTAGG(City, ', ')
; dane wyjściowe: "New York, New York, Boston, Salem, Buffalo, Buffalo, Albany"
LISTAGG(DISTINCT City, ', ')
; dane wyjściowe: "New York, Boston, Salem, Buffalo Albany"
LISTAGG(City, ', ' ON OVERFLOW TRUNCATE '...')
; dane wyjściowe: "New York, New York, Boston, Salem, Buffalo, ..."
Funkcja systemowa USER
zwraca wartości związane z sesją. Na przykład nazwę użytkownika, której bieżący użytkownik użył do zalogowania się.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
DATABASE |
Zwraca nazwę obszaru tematycznego, do którego bieżący użytkownik jest zalogowany. |
|
|
USER |
Zwraca nazwę użytkownika dla modelu semantycznego, do którego bieżący użytkownik jest zalogowany. |
|
Funkcje ciągów czasowych umożliwiają agregowanie i prognozowanie danych na podstawie wymiarów czasu. Na przykład za pomocą funkcji AGO można obliczyć przychód z okresu wypadającego rok wcześniej.
Elementy wymiarów "czas" muszą być na poziomie danej funkcji lub poniżej tego poziomu. Z tego powodu kolumny jednoznacznie identyfikujące elementy na danym poziomie lub poniżej tego poziomu muszą wystąpić w zapytaniu.
Funkcja | Przykład | Opis | Składnia |
---|---|---|---|
AGO |
|
Umożliwia obliczenie zagregowanej wartości miary w wybranym okresie w przeszłości. Na przykład, aby obliczyć przychód z miesiąca wypadającego rok wcześniej, należy użyć funkcji |
Gdzie:
|
PERIODROLLING |
|
Oblicza agregowaną wartość miary w okresie rozpoczynającym się x przedziałów czasu i kończącym się y przedziałów czasu względem bieżącego czasu. Na przykład funkcja |
Gdzie:
|
TODATE |
|
Umożliwia obliczenie zagregowanej wartości miary od początku okresu do ostatniego okresu, na przykład mogą to być obliczenia dotyczące okresu od początku roku do danego dnia. Na przykład, aby obliczyć wartość sprzedaży od początku roku do danego dnia, należy użyć funkcji |
Gdzie:
|