| --- |
| { |
| "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つのパラメータを持つ必要があります。 |
