| --- |
| { |
| "title": "エイリアス関数", |
| "language": "ja", |
| "description": "エイリアス関数とは、関数にエイリアス名を割り当てることを指します。システム内で関数または式フラグメントに新しいシグネチャを登録することにより、" |
| } |
| --- |
| ## はじめに |
| |
| エイリアス関数とは、関数にエイリアス名を割り当てることを指します。システム内で関数や式フラグメントに新しいシグネチャを登録することで、互換性の向上や利便性の向上を目的としています。 |
| |
| エイリアス関数は、他のカスタム関数と同様に、`LOCAL`と`GLOBAL`の2つのスコープをサポートします。 |
| |
| - `LOCAL`: エイリアス関数は現在のデータベーススコープ下に登録されます。他のデータベース下でエイリアス関数を使用する必要がある場合は、完全修飾名を使用する必要があります。すなわち、`<Database Name>.<Function Name>`です。 |
| |
| - `GLOBAL`: エイリアス関数はグローバルスコープ下に登録されます。どのデータベース下でも関数名で直接アクセスできます。 |
| |
| ## 使用例 |
| |
| ### 関数へのエイリアスの割り当て |
| |
| このシナリオはシステム移行でよく見られます。ユーザーが他のデータベースシステムを対象とした既存のクエリを持っている場合、これらのクエリにはDorisの関数と同じ機能を持つが名前が異なる関数が含まれている可能性があります。この場合、この関数に新しいエイリアス関数を定義することで、ユーザーが変更に気づくことなく移行を完了できます。 |
| |
| ### クエリステートメントの簡素化 |
| |
| このシナリオは複雑な分析でよく見られます。複雑なクエリステートメントを書く際、ステートメント内や異なるステートメント間で大量の反復的な式フラグメントが存在する場合があります。この複雑な式フラグメントにエイリアス関数を作成することで、クエリステートメントを簡素化し、記述の利便性と保守性を向上させることができます。 |
| |
| ## サポートされるスコープ |
| |
| ### 式の要件 |
| |
| 現在、エイリアス関数では、参照する実際の式のルートノードが関数式である必要があります。 |
| |
| 有効な例: |
| |
| ```sql |
| -- Create an alias function named func with parameters INT, INT, actually pointing to the expression abs(foo + bar); |
| CREATE ALIAS FUNCTION func(INT, INT) WITH PARAMETER(foo, bar) AS abs(foo + bar); |
| -- Create an alias function named func with parameters DATETIMEV2(3), INT, actually pointing to the expression date_trunc(days_sub(foo, bar), 'day') |
| CREATE ALIAS FUNCTION func(DATETIMEV2(3), INT) WITH PARAMETER (foo, bar) AS date_trunc(days_sub(foo, bar), 'day') |
| ``` |
| 不正な例: |
| |
| ```sql |
| -- The root expression is not a function |
| CREATE ALIAS FUNCTION func(INT, INT) WITH PARAMETER(foo, bar) AS foo + bar; |
| ``` |
| ### パラメータ要件 |
| |
| 現在、alias関数は可変長パラメータをサポートしておらず、少なくとも1つのパラメータを持つ必要があります。 |
