メインコンテンツまでスキップ
バージョン: 26.x

エイリアス機能

概要

エイリアス関数とは、関数にエイリアス名を割り当てることを指します。システム内で関数や式フラグメントに新しいシグネチャを登録することで、互換性の向上や利便性の向上を目的としています。

エイリアス関数は、他のカスタム関数と同様に、LOCALGLOBALの2つのスコープをサポートしています。

  • LOCAL: エイリアス関数は現在のデータベーススコープの下に登録されます。他のデータベースの下でエイリアス関数を使用する必要がある場合は、完全修飾名を使用する必要があります。すなわち、<Database Name>.<ファンクション Name>です。

  • GLOBAL: エイリアス関数はグローバルスコープの下に登録されます。任意のデータベースの下で関数名によって直接アクセスできます。

使用例

関数へのエイリアスの割り当て

このシナリオはシステム移行でよく見られます。ユーザーが他のデータベースシステムを対象とした既存のクエリを持っている場合、これらのクエリにはDorisの関数と同じ機能を持つが名前が異なる関数が含まれている可能性があります。この場合、この関数に新しいエイリアス関数を定義することで、ユーザーが変更に気づくことなく移行を完了できます。

クエリ文の簡素化

このシナリオは複雑な分析でよく見られます。複雑なクエリ文を書く際、1つの文内や異なる文間で大量の繰り返し式フラグメントが存在する場合があります。この複雑な式フラグメントにエイリアス関数を作成することで、クエリ文を簡素化し、記述の利便性と保守性を向上させることができます。

サポートされるスコープ

式の要件

現在、エイリアス関数は、それらが指す実際の式のルートノードが関数式である必要があります。

正当な例:

-- 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')

不正な例:

-- The root expression is not a function  
CREATE ALIAS FUNCTION func(INT, INT) WITH PARAMETER(foo, bar) AS foo + bar;

Parameter Requirements

現在、alias関数は可変長パラメータをサポートしておらず、少なくとも1つのパラメータを持つ必要があります。