SnowConvert AI - SQL Server-Azure Synapse - 組み込み関数¶

NVL( <expr1> , <expr2> )

例¶

SQL Server¶

SELECT ISNULL(NULL, 'SNOWFLAKE') AS COMPANYNAME;

結果:


COMPANYNAME
SNOWFLAKE

Snowflake SQL¶

SELECT
NVL(NULL, 'SNOWFLAKE') AS COMPANYNAME;

結果:


COMPANYNAME
SNOWFLAKE

NEWID¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

uniqueidentifier型の一意な値を作成します。(Transact-SQL の NEWID)。

サンプルソースパターン¶

構文¶

SQL Server¶

NEWID ( )  

Snowflake SQL¶

UUID_STRING()

例¶

警告

ランタイムに一意な ID を生成するため、出力が異なる場合があります

SQL Server¶

SELECT NEWID ( ) AS ID;

結果:


ID
47549DDF-837D-41D2-A59C-A6BC63DF7910

Snowflake SQL¶

SELECT
UUID_STRING( ) AS ID;

結果:


ID
6fd4312a-7925-4ad9-85d8-e039efd82089

NULLIF¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された2つの式が等しい場合、null値を返します。

サンプルソースパターン¶

構文¶

SQL Server¶

NULLIF ( check_expression , replacement_value )  

Snowflake SQL¶

NULLIF( <expr1> , <expr2> )

例¶

SQL Server¶

SELECT NULLIF(6,9) AS RESULT1, NULLIF(5,5) AS RESULT2;

結果:


RESULT1	RESULT2
6	null

Snowflake SQL¶

SELECT
NULLIF(6,9) AS RESULT1,
NULLIF(5,5) AS RESULT2;

結果:


RESULT1	RESULT2
6	null

@@ROWCOUNT¶

Applies to

SQL Server

説明¶

最後のステートメントによって影響を受けた行の数を返します。(Transact-SQL の@@ROWCOUNT)。

サンプルソースパターン¶

構文¶

SQL Server¶

@@ROWCOUNT

Snowflake SQL¶

SQLROWCOUNT

例¶

SQL Server¶

CREATE TABLE table1
(
    column1 INT
);

CREATE PROCEDURE procedure1
AS
BEGIN
    declare @addCount int = 0;

    INSERT INTO table1 (column1) VALUES (1),(2),(3);
    set @addCount = @addCount + @@ROWCOUNT

   select @addCount
END
;
GO

EXEC procedure1;

結果:



3

Snowflake SQL¶

CREATE OR REPLACE TABLE table1
(
    column1 INT
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "transact",  "convertedOn": "11/13/2024",  "domain": "test" }}'
;

CREATE OR REPLACE PROCEDURE procedure1 ()
RETURNS TABLE()
LANGUAGE SQL
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "transact",  "convertedOn": "11/13/2024",  "domain": "test" }}'
EXECUTE AS CALLER
AS
$$
    DECLARE
        ADDCOUNT INT := 0;
        ProcedureResultSet RESULTSET;
    BEGIN
         

        INSERT INTO table1 (column1) VALUES (1),(2),(3);
        ADDCOUNT := :ADDCOUNT + SQLROWCOUNT;
        ProcedureResultSet := (

       select
            :ADDCOUNT);
        RETURN TABLE(ProcedureResultSet);
    END;
$$;

CALL procedure1();

結果:


:ADDCOUNT
3

FORMATMESSAGE¶

Applies to

SQL Server

説明¶

sys.messages内の既存のメッセージ、または指定された文字列からメッセージを構築します。Transact-SQL の FORMATMESSAGE)。

サンプルソースパターン¶

Snowflakeは FORMATMESSAGE 関数をサポートしていないため、その動作をシミュレートするために、 FORMATMESSAGE_UDFを追加しています。

構文¶

SQL Server¶

FORMATMESSAGE ( { msg_number  | ' msg_string ' | @msg_variable} , [ param_value [ ,...n ] ] )  

例¶

SQL Server¶

SELECT FORMATMESSAGE('This is the %s and this is the %s.', 'first variable', 'second variable') AS RESULT;

結果:


RESULT
これが1つ目の変数で、これが2つ目の変数です。

Snowflake¶

SELECT
--** SSC-FDM-TS0008 - FORMATMESSAGE WAS CONVERTED TO CUSTOM UDF FORMATMESSAGE_UDF AND IT MIGHT HAVE A DIFFERENT BEHAVIOR. **
FORMATMESSAGE_UDF('This is the %s and this is the %s.', ARRAY_CONSTRUCT('first variable', 'second variable')) AS RESULT;

結果:


RESULT
これが1つ目の変数で、これが2つ目の変数です。

FORMATMESSAGE_UDF¶

Snowflakeには、 FORMATMESSAGE の機能を持つ関数はありません。 SnowConvert AI は、 FORMATMESSAGE の動作をエミュレートするために、以下のPython UDF を生成します。

CREATE OR REPLACE FUNCTION FORMATMESSAGE_UDF(MESSAGE STRING, ARGS ARRAY)
RETURNS STRING
LANGUAGE python
IMMUTABLE
RUNTIME_VERSION = '3.8'
HANDLER = 'format_py'
as
$$
def format_py(message,args):
  return message % (*args,)
$$;

この UDF は、場合によっては正しく動作しない場合があります。

%I64d プレースホルダーを使用するとエラーになります。
代入引数の数がプレースホルダーの数と異なる場合、エラーになります。
%u や %X のような一部の符号なしプレースホルダーは、値を形式化するときに正しく動作しません。
message_idsは扱えません。

文字列関数¶

このセクションでは、Transact-SQL の文字列関数とSnowflake SQL および JavaScript コードの同等の機能について、Snowflakeでの UDFs の作成に焦点を当てて説明します。

CHAR¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

ASCII テーブルのパラメーターとして送られた整数を半角文字で返します(Transact-SQL の CHAR)。

サンプルソースパターン¶

構文¶

SQL Server¶

CHAR( expression )

Snowflake SQL¶

{CHR | CHAR} ( <input> )

JavaScript¶

String.fromCharCode( expression1, ... , expressionN )

例¶

SQL Server¶

SELECT CHAR(170) AS SMALLEST_A

出力:


SMALLEST_A
ª

Snowflake SQL¶

SELECT
CHAR(170) AS SMALLEST_A;

結果:


SMALLEST_A
ª

JavaScript¶

CREATE OR REPLACE FUNCTION get_char(expression float)
RETURNS string
LANGUAGE JAVASCRIPT
AS
$$
  return String.fromCharCode( EXPRESSION );
$$;

SELECT GET_CHAR(170) SMALLEST_A;

結果:


SMALLEST_A
ª

CHARINDEX¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送信された指定された値が、マッチしたときに最初に出現するインデックスを返します(Transact-SQL の CHARINDEX)。

サンプルソースパターン¶

構文¶

SQL Server¶

CHARINDEX( expression_to_find, expression_to_search [, start] )

Snowflake SQL¶

CHARINDEX( <expr1>, <expr2> [ , <start_pos> ] )

JavaScript¶

String.indexOf( search_value [, index] )

例¶

SQL Server¶

SELECT CHARINDEX('t', 'Customer') AS MatchPosition;

結果:


INDEX
33

Snowflake SQL¶

SELECT
CHARINDEX('t', 'Customer') AS MatchPosition;

結果:


INDEX
33

JavaScript¶

注釈

Transactのインデックスは、 JavaScript が0から始まるのに対して、1から始まります。

CREATE OR REPLACE FUNCTION get_index
(
  expression_to_find varchar, 
  expression_to_search varchar, 
  start_index  float
)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
  return EXPRESSION_TO_SEARCH.indexOf(EXPRESSION_TO_FIND, START_INDEX)+1;
$$;

SELECT GET_INDEX('and', 'Give your heart and soul to me, and life will always be la vie en rose', 20) AS INDEX;

結果:


INDEX
33

COALESCE¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

引数を順に評価し、最初に NULL に評価されなかった1つ目の式の現在値を返します。たとえば、 SELECT COALESCE （ NULL 、 NULL 、'third_value'、'fourth_value'）は、3番目の値を返します。なぜなら、3番目の値はNULLでない最初の値だからです。（ Transact-SQL における COALESCE ）。

サンプルソースパターン¶

構文¶

SQL Server¶

COALESCE ( expression [ ,...n ] )   

Snowflake SQL¶

COALESCE( <expr1> , <expr2> [ , ... , <exprN> ] )

例¶

SQL Server¶

SELECT TOP 10 StartDate, 
COALESCE(EndDate,'2000-01-01') AS FIRST_NOT_NULL 
FROM HumanResources.EmployeeDepartmentHistory

結果:


StartDate	FIRST_NOT_NULL
2009-01-14	2000-01-01
2008-01-31	2000-01-01
2007-11-11	2000-01-01
2007-12-05	2010-05-30
2010-05-31	2000-01-01
2008-01-06	2000-01-01
2008-01-24	2000-01-01
2009-02-08	2000-01-01
2008-12-29	2000-01-01
2009-01-16	2000-01-01

Snowflake SQL¶

SELECT TOP 10
StartDate,
COALESCE(EndDate,'2000-01-01') AS FIRST_NOT_NULL
FROM
HumanResources.EmployeeDepartmentHistory;

結果:


StartDate	FIRST_NOT_NULL
2009-01-14	2000-01-01
2008-01-31	2000-01-01
2007-11-11	2000-01-01
2007-12-05	2010-05-30
2010-05-31	2000-01-01
2008-01-06	2000-01-01
2008-01-24	2000-01-01
2009-02-08	2000-01-01
2008-12-29	2000-01-01
2009-01-16	2000-01-01

CONCAT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列値を他の値と連結します。(Transact-SQL の CONCAT)。

サンプルソースパターン¶

構文¶

SQL Server¶

CONCAT ( string_value1, string_value2 [, string_valueN ] )  

Snowflake SQL¶

CONCAT( <expr1> [ , <exprN> ... ] )

<expr1> || <expr2> [ || <exprN> ... ]

JavaScript¶

 String.concat( expression1, ..., expressionN )

例¶

SQL Server¶

SELECT CONCAT('Ray',' ','of',' ','Light') AS TITLE;

出力:


TITLE
Ray of Light

Snowflake SQL¶

SELECT
CONCAT('Ray',' ','of',' ','Light') AS TITLE;

出力:


TITLE
Ray of Light

JavaScript¶

CREATE OR REPLACE FUNCTION concatenate_strs(strings array)
RETURNS string
LANGUAGE JAVASCRIPT
AS
$$
  var result = ""
  STRINGS.forEach(element => result = result.concat(element));
  return result;
$$;
SELECT concatenate_strs(array_construct('Ray',' ','of',' ','Light')) TITLE;

出力:

   TITLE|

------------| Ray of Light|

LEFT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された文字数の文字列の右部分を返します。(Transact-SQL の RIGHT)。

サンプルソースパターン¶

構文¶

SQL Server¶

LEFT ( character_expression , integer_expression )  

Snowflake SQL¶

LEFT ( <expr> , <length_expr> )

JavaScript¶

動作をエミュレートする関数

function LEFT(string, index){
    if(index < 0){
        throw new RangeError('Invalid INDEX on LEFT function');
    }
    return string.slice( 0, index);
  }
return LEFT(STR, INDEX);

例¶

SQL Server¶

SELECT LEFT('John Smith', 5) AS FIRST_NAME;

出力:


FIRST_NAME
John

Snowflake SQL¶

SELECT LEFT('John Smith', 5) AS FIRST_NAME;

出力:


FIRST_NAME
John

JavaScript¶

CREATE OR REPLACE FUNCTION left_str(str varchar, index float)
RETURNS string
LANGUAGE JAVASCRIPT
AS
$$
    function LEFT(string, index){
      if(index < 0){
          throw new RangeError('Invalid INDEX on LEFT function');
      }
      return string.slice( 0, index);
    }
  return LEFT(STR, INDEX);
$$;
SELECT LEFT_STR('John Smith', 5) AS FIRST_NAME;

出力:


FIRST_NAME
John

LEN¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列の長さを返します(Transact-SQL の LEN)。

サンプルソースパターン¶

構文¶

SQL Server¶

LEN( string_expression )

Snowflake SQL¶

LENGTH( <expression> )
LEN( <expression> )

JavaScript¶

JavaScript SQL 完全ドキュメント

 string.length

例¶

SQL Server¶

SELECT LEN('Sample text') AS [LEN];

出力:


LEN
11

Snowflake SQL¶

SELECT LEN('Sample text') AS LEN;

出力:


LEN
11

JavaScript¶

CREATE OR REPLACE FUNCTION get_len(str varchar)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  return STR.length;
$$;
SELECT GET_LEN('Sample text') LEN;

出力:


LEN
11

LOWER¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列を小文字に変換します(Transact-SQL の LOWER)。

サンプルソースパターン¶

構文¶

SQL Server¶

LOWER ( character_expression )  

Snowflake SQL¶

LOWER( <expr> )

JavaScript¶

JavaScript SQL 完全ドキュメント

 String.toLowerCase( )

例¶

SQL Server¶

SELECT LOWER('YOU ARE A PREDICTION OF THE GOOD ONES') AS LOWERCASE;

出力:


LOWERCASE
you are a prediction of the good ones

Snowflake SQL¶

SELECT LOWER('YOU ARE A PREDICTION OF THE GOOD ONES') AS LOWERCASE;

出力:


LOWERCASE
you are a prediction of the good ones

JavaScript¶

CREATE OR REPLACE FUNCTION to_lower(str varchar)
RETURNS string
LANGUAGE JAVASCRIPT
AS
$$
  return STR.toLowerCase();
$$;

SELECT TO_LOWER('YOU ARE A PREDICTION OF THE GOOD ONES') LOWERCASE;

出力:


LOWERCASE
you are a prediction of the good ones

NCHAR¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた整数の UNICODE 文字を返します(Transact-SQL の NCHAR)。

サンプルソースパターン¶

構文¶

NCHAR( expression )

引数¶

式: 整数式。

返されるタイプ¶

文字列値、受け取った入力に依存します。

例¶

クエリ¶

SELECT NCHAR(170);

結果¶



ª

注釈

JavaScript におけるこの関数の等価性は CHARにドキュメントがあります。

REPLACE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された文字列値のすべての出現を別の文字列値に置き換えます。(Transact-SQL の REPLACE)。

サンプルソースパターン¶

構文¶

SQL Server¶

REPLACE ( string_expression , string_pattern , string_replacement )  

Snowflake SQL¶

REPLACE( <subject> , <pattern> [ , <replacement> ] )

JavaScript¶

 String.replace( pattern, new_expression)

例¶

SQL Server¶

SELECT REPLACE('Real computer software', 'software','science') AS COLUMNNAME;

出力:

COLUMNNAME           |
---------------------|
Real computer science|

Snowflake SQL¶

SELECT REPLACE('Real computer software', 'software','science') AS COLUMNNAME;

出力:

COLUMNNAME           |
---------------------|
Real computer science|

JavaScript¶

 CREATE OR REPLACE FUNCTION REPLACER (str varchar, pattern varchar, new_expression varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
   return STR.replace( PATTERN, NEW_EXPRESSION );
$$;

SELECT REPLACER('Real computer software', 'software', 'science') AS COLUMNNAME;

\ 出力:

COLUMNNAME             |
---------------------|
Real computer science|

REPLICATE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列値を指定回数複製します(Transact-SQL の REPLICATE)。

サンプルソースパターン¶

構文¶

SQL Server¶

REPLICATE( string_expression, number_expression )

Snowflake SQL¶

REPEAT(<input>, <n>)

JavaScript¶

JavaScript ドキュメント

String.repeat( number_expression )

例¶

SQL Server¶

SELECT REPLICATE('Staying alive',5) AS RESULT

結果:

RESULT                                                           |
-----------------------------------------------------------------|
Staying aliveStaying aliveStaying aliveStaying aliveStaying alive|

Snowflake SQL¶

SELECT REPEAT('Staying alive',5) AS RESULT;

結果:

RESULT                                                           |
-----------------------------------------------------------------|
Staying aliveStaying aliveStaying aliveStaying aliveStaying alive|

JavaScript¶

 CREATE OR REPLACE FUNCTION REPEAT_STR (str varchar, occurrences float)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
 
   return STR.repeat( OCCURRENCES );
$$;

SELECT REPEAT_STR('Staying alive ', 5) AS RESULT;

結果:

RESULT                                                           |
-----------------------------------------------------------------|
Staying aliveStaying aliveStaying aliveStaying aliveStaying alive|

RIGHT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された文字数の文字列の右部分を返します。(Transact-SQL の RIGHT)。

サンプルソースパターン¶

構文¶

SQL Server¶

RIGHT ( character_expression , integer_expression )  

Snowflake SQL¶

RIGHT( <expr> , <length_expr> )

JavaScript¶

動作をエミュレートするために使用される UDF

 function RIGHT(string, index){
      if(index< 0){
          throw new RangeError('Invalid INDEX on RIGHT function');
      }
      return string.slice( string.length - index, string.length );
    }

例¶

SQL Server¶

SELECT RIGHT('John Smith', 5) AS LAST_NAME;

出力:

   LAST_NAME|      
------------|
       Smith|   

Snowflake SQL¶

SELECT RIGHT('John Smith', 5) AS LAST_NAME;

出力:

   LAST_NAME|      
------------|
       Smith|   

JavaScript¶

 CREATE OR REPLACE FUNCTION right_str(str varchar, index float)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
    function RIGHT(string, index){
      if(index< 0){
          throw new RangeError('Invalid INDEX on RIGHT function');
      }
      return string.slice( string.length - index, string.length );
    }
  return RIGHT(STR, INDEX);
$$;

SELECT RIGHT_STR('John Smith', 5) AS LAST_NAME;

\ 出力:

   LAST_NAME|      
------------|
       Smith|   

RTRIM¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

先頭の空白を除去した文字式を返します(Transact-SQL の RTRIM)。

サンプルソースパターン¶

構文¶

SQL Server¶

RTRIM( string_expression )

Snowflake SQL¶

RTRIM(<expr> [, <characters> ])

JavaScript¶

動作をエミュレートするために使用されるカスタム関数

 function RTRIM(string){
    return string.replace(/s+$/,"");
}

例¶

SQL Server¶

入力:

SELECT RTRIM('LAST TWO BLANK SPACES  ') AS [RTRIM]

出力:

RTRIM                |
---------------------|
LAST TWO BLANK SPACES|

Snowflake SQL¶

SELECT RTRIM('LAST TWO BLANK SPACES  ') AS RTRIM;

結果:

RTRIM                |
---------------------|
LAST TWO BLANK SPACES|

JavaScript¶

 CREATE OR REPLACE FUNCTION rtrim(str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  function RTRIM(string){
    return string.replace(/s+$/,"");
    }
   return RTRIM( STR );
$$;

SELECT RTRIM('LAST TWO BLANK SPACES  ') AS RTRIM;

結果:

RTRIM                |
---------------------|
LAST TWO BLANK SPACES|

SPACE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

空白の出現回数を返します(Transact-SQL の SPACE)。

サンプルソースパターン¶

構文¶

SQL Server¶

SPACE ( integer_expression )  

Snowflake SQL¶

SPACE(<n>)

JavaScript¶

動作をエミュレートするために使用されるカスタム関数

 function SPACE( occurrences ){
    return ' '.repeat( occurrences );
}

例¶

SQL Server¶

入力:

SELECT CONCAT('SOME', SPACE(5), 'TEXT') AS RESULT;

出力:

RESULT       |
-------------|
SOME     TEXT|

Snowflake SQL¶

入力:

SELECT CONCAT('SOME', SPACE(5), 'TEXT') AS RESULT;

出力:

RESULT       |
-------------|
SOME     TEXT|

JavaScript¶

入力:

 CREATE OR REPLACE FUNCTION SPACE(occurrences float)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
    function SPACE( occurrences ){
    return ' '.repeat( occurrences );
    }
    return SPACE( OCCURRENCES );
$$;

SELECT CONCAT('SOME', SPACE(5), 'TEXT') RESULT;

出力:

RESULT       |
-------------|
SOME     TEXT|

SUBSTRING¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

先頭の空白を除去した文字式を返します(Transact-SQL の RTRIM)。

サンプルソースパターン¶

構文¶

SQL Server¶

SUBSTRING( string_expression, start, length )

Snowflake SQL¶

SUBSTR( <base_expr>, <start_expr> [ , <length_expr> ] )

SUBSTRING( <base_expr>, <start_expr> [ , <length_expr> ] )

JavaScript¶

動作をエミュレートするために使用されるカスタム関数

 string.substring( indexA [, indexB])

例¶

SQL Server¶

入力:

SELECT SUBSTRING('abcdef', 2, 3) AS SOMETEXT;  

出力:

SOMETEXT|
--------|
bcd     |

Snowflake SQL¶

SELECT SUBSTRING('abcdef', 2, 3) AS SOMETEXT;  

結果:

SOMETEXT|
--------|
bcd     |

JavaScript¶

 CREATE OR REPLACE FUNCTION REPLACER_LENGTH(str varchar, index float, length float)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
    var start = INDEX - 1;
    var end = STR.length - (LENGTH - 1);
    return STR.substring(start, end);
$$;

SELECT REPLACER_LENGTH('abcdef', 2, 3) AS SOMETEXT;

結果:

SOMETEXT|
--------|
bcd     |

UPPER¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列を大文字に変換します(Transact-SQL の UPPER)。

サンプルソースパターン¶

構文¶

SQL Server¶

UPPER( string_expression ) 

Snowflake SQL¶

UPPER( <expr> )

JavaScript¶

JavaScript SQL 完全ドキュメント

 String.toUpperCase( )

例¶

SQL Server¶

SELECT UPPER('you are a prediction of the good ones') AS [UPPER]

出力:

+-------------------------------------|
|UPPER                                |
+-------------------------------------|
|YOU ARE A PREDICTION OF THE GOOD ONES|
+-------------------------------------|

Snowflake SQL¶

SELECT
UPPER('you are a prediction of the good ones') AS UPPER;

出力:

+-------------------------------------|
|UPPER                                |
+-------------------------------------|
|YOU ARE A PREDICTION OF THE GOOD ONES|
+-------------------------------------|

JavaScript¶

 CREATE OR REPLACE FUNCTION to_upper(str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  return STR.toUpperCase();
$$;

SELECT TO_UPPER('you are a prediction of the good ones') UPPER;

\ 出力:

UPPER                                |
-------------------------------------|
YOU ARE A PREDICTION OF THE GOOD ONES|

ASCII¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

ASCII テーブル上の文字の番号コードを返します(Transact-SQL の ASCII)。

サンプルソースパターン¶

構文¶

ASCII( expression )

引数¶

式: VARCVHAR または CHAR 式。

返されるタイプ¶

INT。

例¶

クエリ¶

SELECT ASCII('A') AS A , ASCII('a') AS a;

結果¶

          A|          a|
-----------| ----------|
         65|         97|

JS の ASCII¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、 ASCII テーブル上の文字の番号コードを返します(JavaScript charCodeAt 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 string.charCodeAt( [index] )

引数¶

インデックス(オプション): ASCII テーブルで文字を取得してコード番号を返す文字列のインデックス。このパラメーターが指定されない場合、デフォルトとして0を取ります。\

返されるタイプ¶

Int。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION get_ascii(c char)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  return C.charCodeAt();
$$;

SELECT GET_ASCII('A') A, GET_ASCII('a') a;

結果¶

          A|          a|
-----------| ----------|
         65|         97|    

QUOTENAME¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

引用符で区切られた文字列を返します(Transact-SQL の QUOTENAME)。

サンプルソースパターン¶

構文¶

QUOTENAME( string_expression [, quote_character])

引数¶

string_expression: 区切る文字列。

quote_character: 文字列を区切る1文字。

返されるタイプ¶

NVARCHAR(258)。引用符が(')、([])、(")、( () )、( >< )、({})、または(`)と異なる場合はnullになります。

例¶

クエリ¶

SELECT QUOTENAME('Hello', '`') AS HELLO;

結果¶

    HELLO|      
---------|
  `Hello`|  

JS の QUOTENAME¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、この関数は JavaScript では利用できませんが、定義済みの関数を使って実装することができます。

サンプルソースパターン¶

実装例¶

 function QUOTENAME(string, quote){
    return quote.concat(string, quote);
}

引数¶

string: 区切る文字列式。

quote: 区切り文字として使用される引用符。

返されるタイプ¶

文字列。

例¶

クエリ¶

CREATE OR REPLACE FUNCTION QUOTENAME(str varchar, quote char)
RETURNS string
LANGUAGE JAVASCRIPT
AS
$$
  function QUOTENAME(string, quote){
    const allowed_quotes = /[\']|[\"]|[(]|[)]|[\[]|[\]]|[\{]|[\}]|[\`]/;
    
    if(!allowed_quotes.test(quote)) throw new TypeError('Invalid Quote');
    
    return quote.concat(string, quote);
  }
   return QUOTENAME(STR, QUOTE);
$$;

SELECT QUOTENAME('Hola', '`') HELLO;

結果¶

    HELLO|      
---------|
  `Hello`| 

CONCAT_WS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列値と文字列値の間にセパレーターを使用した連結を行います(Transact-SQL の CONCAT_WS)。

サンプルソースパターン¶

構文¶

CONCAT_WS( separator, expression1, ... ,expressionN )

引数¶

separator: 結合するセパレーター。

expression1, ... ,expressionN: 文字列に変換する式。

返されるタイプ¶

文字列値、受け取った入力に依存します。

例¶

クエリ¶

SELECT CONCAT_WS(' ', 'Mariah','Carey') AS NAME;

結果¶

        NAME|      
------------|
Mariah Carey|

JS の結合¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列引数をセパレーターを使用して呼び出し文字列に連結します(JavaScript 結合関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Array.join( separator )

引数¶

separator: 結合する文字。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION join_strs(separator varchar, strings array)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  return STRINGS.join(SEPARATOR);
$$;
SELECT join_strs(' ',array_construct('Mariah','Carey')) NAME;

結果¶

        NAME|      
------------|
Mariah Carey|   

SOUNDEX¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

2つの文字列の類似性を評価するための4文字のコードを返します(Transact-SQL の SOUNDEX)。

サンプルソースパターン¶

構文¶

SOUNDEX( string_expression )

引数¶

string_expression: 反転する文字列式。

返されるタイプ¶

パラメーターとして送られる文字列式と同じデータ型。

例¶

クエリ¶

SELECT SOUNDEX('two') AS TWO , SOUNDEX('too') AS TOO;

結果¶

      TWO|      TOO|
---------|---------|
     T000|     T000|

JS の SOUNDEX¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、 JavaScript は SOUNDEX アルゴリズムを実行するメソッドを提供していませんが、手動で実装することは可能です。

サンプルソースパターン¶

実装例¶

 const dic = {A:0, B:1, C:2, D:3, E:0, F:1, G:2, H:0, I:0, J:2, K:2, L:4, M:5, N:5, O:0, P:1, Q:2, R:6, S:2, T:3, U:0, V:1, W:0, X:2, Y:0, Z:2};

  function getCode(letter){
      return dic[letter.toUpperCase()];
  }

  function SOUNDEX(word){
    var initialCharacter = word[0].toUpperCase();
    var initialCode = getCode(initialCharacter);
    for(let i = 1; i < word.length; ++i) {
        const letterCode = getCode(word[i]);
        if (letterCode && letterCode != initialCode) {
             initialCharacter += letterCode;
             if(initialCharacter.length == 4) break;
        }
        initialCode = letterCode;
    }
      
      return initialCharacter.concat( '0'.repeat( 4 - initialCharacter.length));
      
  }

引数¶

word: 文字列式で SOUNDEX の等価性を取得します。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION get_soundex(str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  const dic = {A:0, B:1, C:2, D:3, E:0, F:1, G:2, H:0, I:0, J:2, K:2, L:4, M:5, N:5, O:0, P:1, Q:2, R:6, S:2, T:3, U:0, V:1, W:0, X:2, Y:0, Z:2};

  function getCode(letter){
      return dic[letter.toUpperCase()];
  }

  function SOUNDEX(word){
    var initialCharacter = word[0].toUpperCase();
    var initialCode = getCode(initialCharacter);
    for(let i = 1; i < word.length; ++i) {
        const letterCode = getCode(word[i]);
        if (letterCode && letterCode != initialCode) {
             initialCharacter += letterCode;
             if(initialCharacter.length == 4) break;
        }
        initialCode = letterCode;
    }
    
    return initialCharacter.concat( '0'.repeat( 4 - initialCharacter.length));    
  }
  
  return SOUNDEX( STR );
$$;

SELECT GET_SOUNDEX('two') AS TWO , GET_SOUNDEX('too') AS TOO;

結果¶

      TWO|      TOO|
---------|---------|
     T000|     T000| 

REVERSE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

文字列を反転します(Transact-SQL の REVERSE)。

サンプルソースパターン¶

構文¶

REVERSE( string_expression )

引数¶

string_expression: 反転する文字列式。

返されるタイプ¶

パラメーターとして送られる文字列式と同じデータ型。

例¶

クエリ¶

SELECT REVERSE('rotator') AS PALINDROME;

結果¶

      PALINDROME|      
----------------|
         rotator|  

JS の反転¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、この関数は JavaScript では利用できませんが、定義済みの関数を使って実装することができます。

サンプルソースパターン¶

実装例¶

 function REVERSE(string){
    return string.split("").reverse().join("");
}

引数¶

string: 反転する文字列式。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION REVERSE(str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
   return STR.split("").reverse().join("");
$$;

SELECT REVERSE('rotator') PALINDROME;

結果¶

      PALINDROME|      
----------------|
         rotator|  

STRING_ESCAPE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

テキストの特殊文字をエスケープし、エスケープされた文字を含むテキストを返します。(Transact-SQL の STRING_ESCAPE)。

サンプルソースパターン¶

構文¶

STRING_ESCAPE( text, type )

引数¶

text: 文字をエスケープするテキスト。

type: 文字をエスケープする形式型。現在、 JSON が唯一サポートされている形式です。

返されるタイプ¶

VARCHAR。

例¶

クエリ¶

SELECT STRING_ESCAPE('\   /  \\    "     ', 'json') AS [ESCAPE];  

結果¶

ESCAPE|
--------------------------|
  \\   \/  \\\\    \"     |

JS のstringify¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

オブジェクトを JSON 文字列形式に変換します(JavaScript stringify関数ドキュメント)。

サンプルソースパターン¶

構文¶

 JSON.stringify( value )

引数¶

value: 変換するオブジェクト式。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION string_escape (str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
   return JSON.stringify( STR );
$$;

SELECT STRING_ESCAPE('\   /  \\    "     ') ESCAPE;

結果¶

                    ESCAPE|
--------------------------|
  \\   \/  \\\\    \"     | 

TRIM¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

空白を含まない文字式を返します(Transact-SQL の TRIM)。

サンプルソースパターン¶

構文¶

TRIM( string_expression )

引数¶

string_expression: 変換する文字列式。

返されるタイプ¶

VARCHAR または NVARCHAR

例¶

SQL Server¶

SELECT TRIM('  FIRST AND LAST TWO BLANK SPACES  ') AS [TRIM];

出力:

+-------------------------------|
|TRIM                           |
+-------------------------------|
|FIRST AND LAST TWO BLANK SPACES|
+-------------------------------|

Snowflake SQL¶

SELECT TRIM('  FIRST AND LAST TWO BLANK SPACES  ') AS TRIM;

出力:

+-------------------------------|
|TRIM                           |
+-------------------------------|
|FIRST AND LAST TWO BLANK SPACES|
+-------------------------------|

JS のtrim¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた新しいパターンを使って、出現するパターンを置き換えます(JavaScript Replace関数ドキュメント)。

サンプルソースパターン¶

構文¶

 String.trim( )

引数¶

この関数はパラメーターを受け取りません。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION TRIM_STR(str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
   return STR.trim( );
$$;

SELECT TRIM_STR('  FIRST AND LAST TWO BLANK SPACES  ')TRIM

結果¶

                           TRIM|      
-------------------------------|
FIRST AND LAST TWO BLANK SPACES|   

DIFFERENCE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

SOUNDEX アルゴリズムを使用して、2つの文字列の差を測定する整数を返します。(Transact-SQL の DIFFERENCE)。\ SOUNDEX アルゴリズムを実行して生成された文字列の共通文字をカウントします。

サンプルソースパターン¶

構文¶

DIFFERENCE( expression1, expression1 )

引数¶

expression1, expression2: 比較する文字列式。

返されるタイプ¶

Int。

例¶

クエリ¶

SELECT DIFFERENCE('Like', 'Mike');

結果¶

    Output |
-----------|
         3 |

JS の DIFFERENCE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、この機能は JS では利用できませんが、簡単に実装することができます。

注釈

この関数は SOUNDEX アルゴリズムの実装を必要とします。

サンプルソースパターン¶

実装例¶

 function DIFFERENCE(strA, strB) {
    var count = 0;
    for (var i = 0; i < strA.length; i++){
       if ( strA[i] == strB[i] ) count++; 
    }
    
    return count;
}

引数¶

strA, strB: SOUNDEX アルゴリズムを実行した結果の文字列式。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION SOUNDEX_DIFFERENCE(str_1 varchar, str_2 varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
    function DIFFERENCE(strA, strB) {
      var count = 0;
      for (var i = 0; i < strA.length; i++){
         if ( strA[i] == strB[i] ) count++; 
      }
    
    return count;
    }
    
    return DIFFERENCE(STR_1, STR_2);
$$;

SELECT SOUNDEX_DIFFERENCE(GET_SOUNDEX('two'), GET_SOUNDEX('too')) DIFFERENCE;

結果¶

   DIFFERENCE|
-------------|
            4| 

FORMAT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定した形式とオプションのカルチャーで形式化された値を返します(Transact-SQL の FORMAT)。

サンプルソースパターン¶

構文¶

FORMAT( value, format [, culture])

引数¶

value: 形式を指定する文字列式。

format: 希望する形式。

culture（オプション）: カルチャーを指定する NVarchar 引数。指定されていない場合は、現在のセッションの言語を使用します。

返されるタイプ¶

cultureパラメーターが無効な場合は NULL、それ以外の場合は次のデータ型に従います。


カテゴリ		.NET 型
数値	bigint	Int64
数値	int	Int32
数値	smallint	Int16
数値	tinyint	Byte
数値	decimal	SqlDecimal
数値	数値	SqlDecimal
数値	float	Double
数値	real	Single
数値	smallmoney	10進数
数値	money	10進数
日付と時刻	date	DateTime
日付と時刻	time	TimeSpan
日付と時刻	datetime	DateTime
日付と時刻	smalldatetime	DateTime
日付と時刻	datetime2	DateTime
日付と時刻	datetimeoffset	DateTimeOffset

例¶

クエリ¶

SELECT FORMAT(CAST('2022-01-24' AS DATE), 'd', 'en-gb')  AS 'Great Britain';

結果¶

  GREAT BRITAIN|
---------------|
     24/01/2022|  

クエリ¶

SELECT FORMAT(244900.25, 'C', 'cr-CR')  AS 'CURRENCY';

結果¶


CURRENCY
₡244,900.25

JS の FORMAT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

JavaScript には、日付や整数値を形式化するさまざまな関数があります。残念ながら、これらの機能は1つのメソッドに統合されていません。

DateTime 値¶

構文¶

 Intl.DateTimeFormat( format ).format( value )

引数¶

locales （オプション）: 適用する形式の文字列式。

options （オプション）: 数値式の形式のためにサポートされるさまざまなプロパティを持つオブジェクト(JavaScript NumberFormat 関数ドキュメント)。

value: 形式を指定する数値式。

返されるタイプ¶

文字列。

数値¶

構文¶

 Intl.NumberFormat( [locales [, options]] ).format( value )

引数¶

locales （オプション）: 適用する形式の文字列式。

options （オプション）: 数値式の形式のためにサポートされるさまざまなプロパティを持つオブジェクト(JavaScript NumberFormat 関数ドキュメント)。

value: 形式を指定する数値式。

返されるタイプ¶

文字列。

例¶

DateTime¶

クエリ¶

 CREATE OR REPLACE FUNCTION format_date(date timestamp, format varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  return new Intl.DateTimeFormat( FORMAT ).format( DATE );
$$;
SELECT FORMAT_DATE(TO_DATE('2022-01-24'), 'en-gb') GREAT_BRITAIN;

結果¶

  GREAT_BRITAIN|      
---------------|
     24/01/2022|  

数値¶

クエリ¶

 CREATE OR REPLACE FUNCTION format_numeric(number float, locales varchar, options variant)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  return new Intl.NumberFormat( LOCALES , OPTIONS ).format( NUMBER );
$$;
SELECT FORMAT_NUMERIC(244900.25, 'de-DE', PARSE_JSON('{ style: "currency", currency: "CRC" }')) CURRENCY;

結果¶

       CURRENCY|      
---------------|
 244.900,25 CRC|  

PATINDEX¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定した式で、最初に出現するパターンの開始位置を返します(Transact-SQL の PATINDEX)。

サンプルソースパターン¶

構文¶

PATINDEX( pattern, expression )

引数¶

pattern: 探すパターン。

expression: 検索する式。

返されるタイプ¶

整数。パターンが見つからない場合は0を返します。

例¶

クエリ¶

SELECT PATINDEX( '%on%', 'No, no, non esistono più') AS [PATINDEX]

結果¶

    PATINDEX|      
------------|
          10|  

JS の検索¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

REGEX を使用して、パターンのインデックスを検索します(JavaScript 検索関数ドキュメント)。

サンプルソースパターン¶

構文¶

 String.search( regex )

引数¶

regex: 希望するパターンにマッチする正規表現。

返されるタイプ¶

整数。パターンが文字列のどの部分とも一致しない場合は-1を返します。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION get_index_pattern(pattern varchar, str varchar)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
  function GET_PATTERN(pattern, string){
    return string.search(new RegExp( pattern ));
    }
   return GET_PATTERN(PATTERN, STR) + 1;
$$;

SELECT GET_INDEX_PATTERN('on+', 'No, no, non esistono più') PATINDEX;

結果¶

    PATINDEX|      
------------|
          10|  

STR¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

数値データを文字データに変換して返します。文字データは右寄せで、長さと10進数の精度が指定されます。(Transact-SQL の STR)。

サンプルソースパターン¶

構文¶

SQL Server¶

STR ( float_expression [ , length [ , decimal ] ] )

Snowflake SQL¶

STR_UDF( numeric_expression, number_format )

引数¶

numeric_expression: 小数点を含むFloat式。

length （オプション）: ポイント表記、10進数、float部分を含む、返される式の長さ。

decimal （オプション）: 小数点以下の桁数です。

返されるタイプ¶

VARCHAR。

例¶

SQL Server¶

入力:

/* 1 */
SELECT STR(123.5);

/* 2 */
SELECT STR(123.5, 2);

/* 3 */
SELECT STR(123.45, 6);

/* 4 */
SELECT STR(123.45, 6, 1);

出力:

1) 124
2) **
3) 123
4) 123.5

Snowflake SQL¶

入力:

/* 1 */
SELECT
PUBLIC.STR_UDF(123.5, '99999');

/* 2 */
SELECT
PUBLIC.STR_UDF(123.5, '99');

/* 3 */
SELECT
PUBLIC.STR_UDF(123.45, '999999');

/* 4 */
SELECT
PUBLIC.STR_UDF(123.45, '9999.9');

出力:

1) 124

2) ##

3) 123
4) 123.5

JS の STR¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、この機能は JS では利用できませんが、文字列用の定義済み関数を使えば簡単に実装できます。

サンプルソースパターン¶

実装例¶

 function validLength(number, max_length, float_precision) {
  var float_point = number.match(/[\.][0-9]+/);
  /*if the number does not have point float, checks if the float precision 
   * and current number are greater than max_length
   */
   if(!float_point) return number.length + float_precision + 1 < max_length; 
    //removes the '.' and checks if there is overflow with the float_precision
    return number.length - float_point[0].trim('.').length + float_precision  < max_length;
} 
 function STR(number, max_length, float_precision) {
  var number_str = number.toString();
   //if the expression exceeds the max_length, returns '**'
   if(number_str.length > max_length || float_precision > max_length) return '**';
   if(validLength(number_str, max_length, float_precision)) {
      return number.toFixed(float_precision);
    }
    return number.toFixed(max_length - float_precision);
}

引数¶

number: 小数点を含むFloat式。

max_length: ポイント表記、10進数、float部分を含む、返される式の長さ。

float_precision: 小数点以下の桁数です。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION STR(number float, max_length float, float_precision float)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
    function validLength(number, max_length, float_precision) {
        var float_point = number.match(/[\.][0-9]+/);
        if(!float_point) return number.length + float_precision + 1 < max_length; 
        return number.length - float_point[0].trim('.').length + float_precision  < max_length;
    } 
    function STR(number, max_length, float_precision) {
      var number_str = number.toString();
      if(number_str.length > max_length || float_precision > max_length) return '**';
      if(validLength(number_str, max_length, float_precision)) {
        return number.toFixed(float_precision);
      }
      return number.toFixed(max_length - float_precision);
    }
    return STR( NUMBER, MAX_LENGTH, FLOAT_PRECISION );
$$;

SELECT STR(12345.674, 12, 6);

結果¶

           STR|
--------------|
  12345.674000| 

LTRIM¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

先頭の空白を除去した文字式を返します(Transact-SQL の LTRIM)。

サンプルソースパターン¶

構文¶

LTRIM( string_expression )

引数¶

string_expression: 変換する文字列式。

返されるタイプ¶

VARCHAR または NVARCHAR

例¶

クエリ¶

SELECT LTRIM('  FIRST TWO BLANK SPACES') AS [LTRIM]

結果¶

                 LTRIM|      
----------------------|
FIRST TWO BLANK SPACES|  

JS の LTRIM¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、この関数は JavaScript では利用できませんが、正規表現を使って実装することができます。

サンプルソースパターン¶

実装例¶

 function LTRIM(string){
    return string.replace(/^s+/,"");
}

引数¶

string: 空白を除去する文字列式。

返されるタイプ¶

文字列。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION ltrim(str varchar)
  RETURNS string
  LANGUAGE JAVASCRIPT
AS
$$
  function LTRIM(string){
    return string.replace(/^s+/,"");
    }
   return LTRIM(S TR );
$$;

SELECT LTRIM('  FIRST TWO BLANK SPACES') AS LTRIM;

結果¶

                 LTRIM|      
----------------------|
FIRST TWO BLANK SPACES|  

DENSE_RANK¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

この関数は、結果セットパーティション内の各行の順位を、順位値にギャップがない状態で返します。特定の行の順位は、1にその行の前にある別個の順位値の数を足したものになります。(Transact-SQL の DENSE_RANK)。

サンプルソースパターン¶

構文¶

SQL Server¶

 DENSE_RANK ( ) OVER ( [ <partition_by_clause> ] < order_by_clause > )  

Snowflake SQL¶

 DENSE_RANK( )
-- ** SSC-EWI-0001 - UNRECOGNIZED TOKEN ON LINE '1' COLUMN '15' OF THE SOURCE CODE STARTING AT 'OVER'. EXPECTED 'BATCH' GRAMMAR. CODE '80'. **
--              OVER ( [ <partition_by_clause> ] < order_by_clause > )

例¶

SQL Server¶

SELECT TOP 10 BUSINESSENTITYID, NATIONALIDNUMBER, RANK() OVER (ORDER BY NATIONALIDNUMBER) AS RANK FROM HUMANRESOURCES.EMPLOYEE AS TOTAL

結果:

BUSINESSENTITYID|NATIONALIDNUMBER|DENSE_RANK|
----------------|----------------|----------|
              57|10708100        |         1|
              54|109272464       |         2|
             273|112432117       |         3|
               4|112457891       |         4|
             139|113393530       |         5|
             109|113695504       |         6|
             249|121491555       |         7|
             132|1300049         |         8|
             214|131471224       |         9|
              51|132674823       |        10|

Snowflake SQL¶

SELECT TOP 10
BUSINESSENTITYID,
NATIONALIDNUMBER,
RANK() OVER (ORDER BY NATIONALIDNUMBER) AS RANK
FROM
HUMANRESOURCES.EMPLOYEE AS TOTAL;

結果:

BUSINESSENTITYID|NATIONALIDNUMBER|DENSE_RANK|
----------------|----------------|----------|
              57|10708100        |         1|
              54|109272464       |         2|
             273|112432117       |         3|
               4|112457891       |         4|
             139|113393530       |         5|
             109|113695504       |         6|
             249|121491555       |         7|
             132|1300049         |         8|
             214|131471224       |         9|
              51|132674823       |        10|

RANK¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

結果セットのパーティション内の各行の順位を返します。行の順位は1に当該行の前の順位の数を足したものになります。(Transact-SQL の RANK)。

サンプルソースパターン¶

構文¶

SQL Server¶

 RANK ( ) OVER ( [ partition_by_clause ] order_by_clause )  

Snowflake SQL¶

 RANK( )
-- ** SSC-EWI-0001 - UNRECOGNIZED TOKEN ON LINE '1' COLUMN '9' OF THE SOURCE CODE STARTING AT 'OVER'. EXPECTED 'BATCH' GRAMMAR. CODE '80'. **
--        OVER ( [ partition_by_clause ] order_by_clause )

例¶

SQL Server¶

SELECT TOP 10 BUSINESSENTITYID, NATIONALIDNUMBER, RANK() OVER (ORDER BY NATIONALIDNUMBER) AS RANK FROM HUMANRESOURCES.EMPLOYEE AS TOTAL

結果:

BUSINESSENTITYID|NATIONALIDNUMBER|RANK|
----------------|----------------|----|
              57|10708100        |   1|
              54|109272464       |   2|
             273|112432117       |   3|
               4|112457891       |   4|
             139|113393530       |   5|
             109|113695504       |   6|
             249|121491555       |   7|
             132|1300049         |   8|
             214|131471224       |   9|
              51|132674823       |  10|

Snowflake SQL¶

SELECT TOP 10
BUSINESSENTITYID,
NATIONALIDNUMBER,
RANK() OVER (ORDER BY NATIONALIDNUMBER) AS RANK
FROM
HUMANRESOURCES.EMPLOYEE AS TOTAL;

結果:

BUSINESSENTITYID|NATIONALIDNUMBER|RANK|
----------------|----------------|----|
              57|10708100        |   1|
              54|109272464       |   2|
             273|112432117       |   3|
               4|112457891       |   4|
             139|113393530       |   5|
             109|113695504       |   6|
             249|121491555       |   7|
             132|1300049         |   8|
             214|131471224       |   9|
              51|132674823       |  10|

ROW_NUMBER¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

結果セットの出力に番号を付けます。具体的には、結果セットのパーティション内の行の連番を返します。各パーティションの最初の行は1から始まります。(Transact-SQL の ROW_NUMBER)。

サンプルソースパターン¶

構文¶

SQL Server¶

 ROW_NUMBER ( )   
    OVER ( [ PARTITION BY value_expression , ... [ n ] ] order_by_clause )  

Snowflake SQL¶

 ROW_NUMBER( )
-- ** SSC-EWI-0001 - UNRECOGNIZED TOKEN ON LINE '2' COLUMN '5' OF THE SOURCE CODE STARTING AT 'OVER'. EXPECTED 'BATCH' GRAMMAR. CODE '80'. **
--    OVER ( [ PARTITION BY value_expression , ... [ n ] ] order_by_clause )

例¶

SQL Server¶

SELECT 
ROW_NUMBER() OVER(ORDER BY NAME  ASC) AS RowNumber, 
NAME
FROM HUMANRESOURCES.DEPARTMENT

出力:

RowNumber|NAME                      |
---------|--------------------------|
        1|Document Control          |
        2|Engineering               |
        3|Executive                 |
        4|Facilities and Maintenance|
        5|Finance                   |
        6|Human Resources           |
        7|Information Services      |
        8|Marketing                 |
        9|Production                |
       10|Production Control        |
       11|Purchasing                |
       12|Quality Assurance         |
       13|Research and Development  |
       14|Sales                     |
       15|Shipping and Receiving    |
       16|Tool Design               |

Snowflake SQL¶

SELECT
ROW_NUMBER() OVER(ORDER BY NAME ASC) AS RowNumber,
NAME
FROM
HUMANRESOURCES.DEPARTMENT;

出力:

RowNumber|NAME                      |
---------|--------------------------|
        1|Document Control          |
        2|Engineering               |
        3|Executive                 |
        4|Facilities and Maintenance|
        5|Finance                   |
        6|Human Resources           |
        7|Information Services      |
        8|Marketing                 |
        9|Production                |
       10|Production Control        |
       11|Purchasing                |
       12|Quality Assurance         |
       13|Research and Development  |
       14|Sales                     |
       15|Shipping and Receiving    |
       16|Tool Design               |

論理関数¶

This section describes the functional equivalents of logical functions in Transact-SQL to Snowflake SQL and JavaScript code, oriented to their usage in stored procedures in Snowflake.

IIF¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

ブール式がtrueと評価されるかfalseと評価されるかに応じて、2つの値のどちらかを返します。(Transact-SQL の IIF)。

サンプルソースパターン¶

構文¶

SQL Server¶

IIF( boolean_expression, true_value, false_value )

Snowflake SQL¶

IFF( <condition> , <expr1> , <expr2> )

例¶

SQL Server¶

SELECT IIF( 2 > 3, 'TRUE', 'FALSE' ) AS RESULT

結果:

RESULT|
------|
 FALSE|

Snowflake SQL¶

SELECT
IFF( 2 > 3, 'TRUE', 'FALSE' ) AS RESULT;

結果:

RESULT|
------|
 FALSE|

XML 関数¶

このセクションでは、Transact-SQL と SnowflakeSQL での XML 関数の変換について説明します。

クエリ¶

Applies to

SQL Server

警告

この変換は将来的に実現されるでしょう

説明¶

xml データ型のインスタンスに対して XQuery を指定します。結果は xml 型です。このメソッドは、型付けされていない XML のインスタンスを返します。(Transact-SQL のQuery())

サンプルソースパターン ¶

次の例は、.query( )の変換の詳細です

SQL Server ¶

入力¶

 CREATE TABLE xml_demo(object_col XML);

INSERT INTO xml_demo (object_col)
   SELECT
        '<Root>
<ProductDescription ProductID="1" ProductName="Road Bike">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

INSERT INTO xml_demo (object_col)
   SELECT
        '<Root>
<ProductDescription ProductID="2" ProductName="Skate">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

SELECT
    xml_demo.object_col.query('/Root/ProductDescription/Features/Warranty') as Warranty,
    xml_demo.object_col.query('/Root/ProductDescription/Features/Maintenance') as Maintenance
from xml_demo;

出力¶

 Warranty                                     | Maintenance                                                                          |
----------------------------------------------|--------------------------------------------------------------------------------------|
<Warranty>1 year parts and labor</Warranty>   | <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>  |
<Warranty>1 year parts and labor</Warranty>   | <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>  |

Snowflake SQL ¶

入力¶

 CREATE OR REPLACE TABLE xml_demo (
    object_col VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - XML DATA TYPE CONVERTED TO VARIANT ***/!!!
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "transact",  "convertedOn": "07/11/2025",  "domain": "no-domain-provided" }}'
;

INSERT INTO xml_demo (object_col)
SELECT
        '<Root>
<ProductDescription ProductID="1" ProductName="Road Bike">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

INSERT INTO xml_demo (object_col)
SELECT
        '<Root>
<ProductDescription ProductID="2" ProductName="Skate">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

SELECT
    XMLGET(XMLGET(XMLGET(object_col, 'ProductDescription'), 'Features'), 'Warranty') as Warranty,
    XMLGET(XMLGET(XMLGET(object_col, 'ProductDescription'), 'Features'), 'Maintenance') as Maintenance
from
    xml_demo;

出力¶

 Warranty                                     | Maintenance                                                                          |
----------------------------------------------|--------------------------------------------------------------------------------------|
<Warranty>1 year parts and labor</Warranty>   | <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>  |
<Warranty>1 year parts and labor</Warranty>   | <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>  |

既知の問題¶

問題は見つかりませんでした。

値¶

Applies to

SQL Server

警告

この変換は将来的に実現されるでしょう

説明¶

XML に対して XQuery を実行し、 SQL 型の値を返します。このメソッドはスカラー値を返します。(Transact-SQL のvalue())。

サンプルソースパターン ¶

次の例は、.value( )の変換の詳細です

SQL Server ¶

入力¶

 CREATE TABLE xml_demo(object_col XML);

INSERT INTO xml_demo (object_col)
   SELECT
        '<Root>
<ProductDescription ProductID="1" ProductName="Road Bike">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

INSERT INTO xml_demo (object_col)
   SELECT
        '<Root>
<ProductDescription ProductID="2" ProductName="Skate">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

SELECT
    xml_demo.object_col.value('(/Root/ProductDescription/@ProductID)[1]', 'int' ) as ID,
    xml_demo.object_col.value('(/Root/ProductDescription/@ProductName)[1]', 'varchar(max)' ) as ProductName,
    xml_demo.object_col.value('(/Root/ProductDescription/Features/Warranty)[1]', 'varchar(max)' ) as Warranty
from xml_demo;

出力¶

 ID | ProductName | Warranty               |
----|-------------|------------------------|
1   | Road Bike   | 1 year parts and labor |
2   | Skate       | 1 year parts and labor |

Snowflake SQL ¶

入力¶

 CREATE OR REPLACE TABLE xml_demo (
    object_col VARIANT !!!RESOLVE EWI!!! /*** SSC-EWI-0036 - XML DATA TYPE CONVERTED TO VARIANT ***/!!!
)
COMMENT = '{ "origin": "sf_sc", "name": "snowconvert", "version": {  "major": 0,  "minor": 0,  "patch": "0" }, "attributes": {  "component": "transact",  "convertedOn": "07/11/2025",  "domain": "no-domain-provided" }}'
;

INSERT INTO xml_demo (object_col)
SELECT
        '<Root>
<ProductDescription ProductID="1" ProductName="Road Bike">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

INSERT INTO xml_demo (object_col)
SELECT
        '<Root>
<ProductDescription ProductID="2" ProductName="Skate">
<Features>
  <Warranty>1 year parts and labor</Warranty>
  <Maintenance>3 year parts and labor extended maintenance is available</Maintenance>
</Features>
</ProductDescription>
</Root>';

SELECT
    GET(XMLGET(object_col, 'ProductDescription'), '@ProductID') :: INT as ID,
    GET(XMLGET(object_col, 'ProductDescription'), '@ProductName') :: VARCHAR as ProductName,
    GET(XMLGET(XMLGET(XMLGET(object_col, 'ProductDescription'), 'Features'), 'Warranty', 0), '$') :: VARCHAR as Warranty
from
    xml_demo;

出力¶

 ID | PRODUCTNAME | WARRANRTY              |
----|-------------|------------------------|
1   | Road Bike   | 1 year parts and labor |
2   | Skate       | 1 year parts and labor |

既知の問題¶

問題は見つかりませんでした。

集計関数¶

このセクションでは、Transact-SQL の集計関数とSnowflake SQL および JavaScript コードの同等の機能について、Snowflakeでの UDFs の作成に焦点を当てて説明します。

COUNT¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

この関数は、グループ内で見つかった項目の数を返します。COUNT は COUNT_BIG 関数のように動作します。これらの関数は、戻り値のデータ型が異なるだけです。COUNT は常にintデータ型の値を返します。COUNT_BIG は常にbigintデータ型の値を返します。(Transact-SQL の COUNT)。

サンプルソースパターン¶

構文¶

SQL Server¶

COUNT ( { [ [ ALL | DISTINCT ] expression ] | * } )  

Snowflake SQL¶

COUNT( [ DISTINCT ] <expr1> [ , <expr2> ... ] )

例¶

SQL Server¶

SELECT COUNT(NATIONALIDNUMBER) FROM HUMANRESOURCES.EMPLOYEE AS TOTAL;

結果:


TOTAL
290

Snowflake SQL¶

SELECT
COUNT(NATIONALIDNUMBER) FROM
HUMANRESOURCES.EMPLOYEE AS TOTAL;

結果:


TOTAL
290

COUNT_BIG¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

この関数は、グループ内で見つかった項目の数を返します。COUNT_BIG は、 COUNT 関数のように動作します。これらの関数は、戻り値のデータ型が異なるだけです。COUNT_BIG は常にbigintデータ型の値を返します。COUNT は常にintデータ型の値を返します。(Transact-SQL の COUNT_BIG)。

サンプルソースパターン¶

構文¶

SQL Server¶

COUNT_BIG ( { [ [ ALL | DISTINCT ] expression ] | * } )  

Snowflake SQL¶

COUNT( [ DISTINCT ] <expr1> [ , <expr2> ... ] )

例¶

SQL Server¶

SELECT COUNT_BIG(NATIONALIDNUMBER) FROM HUMANRESOURCES.EMPLOYEE AS TOTAL;

結果:


TOTAL
290

Snowflake SQL¶

SELECT
COUNT(NATIONALIDNUMBER) FROM
HUMANRESOURCES.EMPLOYEE AS TOTAL;

結果:


TOTAL
290

SUM¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

式中のすべての値、または DISTINCT の値のみの合計を返します。SUM は数値列でのみ使用できます。Null値は無視されます。(Transact-SQL の SUM)。

サンプルソースパターン¶

構文¶

SQL Server¶

SUM ( [ ALL | DISTINCT ] expression )  

Snowflake SQL¶

SUM( [ DISTINCT ] <expr1> )

例¶

SQL Server¶

SELECT SUM(VACATIONHOURS) FROM HUMANRESOURCES.EMPLOYEE AS TOTALVACATIONHOURS;

結果:


TOTALVACATIONHOURS
14678

Snowflake SQL¶

SELECT
SUM(VACATIONHOURS) FROM
HUMANRESOURCES.EMPLOYEE AS TOTALVACATIONHOURS;

結果:


TOTALVACATIONHOURS
14678

SnowConvert AI カスタム UDFs¶

説明¶

Transact-SQL 関数や動作の中には、Snowflakeで使用できないものや、動作が異なるものがあります。これらの違いを最小限にするため、一部の関数は SnowConvert AI カスタム UDFs に置き換えられます。

これらの UDFs は、移行中に、 出力 フォルダー内の UDF ヘルパー フォルダーに自動的に作成されます。カスタム UDF ごとに1つのファイルがあります。

OPENXML UDF¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

このカスタム UDF は、 XML ドキュメント上の行セットビューを処理するために追加されます。これは、行セットプロバイダーとして動作するため、宣言に使用されます。

このバージョンの UDF では、オプションパラメーターと異なるノードタイプはサポートされていません。要素ノードはデフォルトで処理されます。

カスタム UDF オーバーロード¶

パラメーター

XML: XML の読み取り可能な内容を表す VARCHAR。
PATH: 行として処理されるノードのパターンを含むvarchar。

UDF¶

CREATE OR REPLACE FUNCTION OPENXML_UDF(XML VARCHAR, PATH VARCHAR)
RETURNS TABLE(VALUE VARIANT)
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"udf"}}'
AS
$$
SELECT VALUE from TABLE(FLATTEN(input=>XML_JSON_SIMPLE(PARSE_XML(XML)), path=>PATH))
$$;


CREATE OR REPLACE FUNCTION XML_JSON_SIMPLE(XML VARIANT)
RETURNS OBJECT
LANGUAGE JAVASCRIPT
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"udf"}}'
AS
$$
function toNormalJSON(xmlJSON) {
    var finalres = {};
    var name=xmlJSON['@'];
    var res = {};
    finalres[name] = res;
    for(var key in xmlJSON)
    {
        if (key == "@")
        {
            res["$name"] = xmlJSON["@"];
        }
        else if (key == "$") {
            continue;
        }
        else if (key.startsWith("@"))
        {
            // This is an attribute
            res[key]=xmlJSON[key];
        }
        else
        {
            var elements = xmlJSON['$']
            var value = xmlJSON[key];
            res[key] = [];
            if (Array.isArray(value))
            {
                for(var elementKey in value)
                {
                    var currentElement = elements[elementKey];
                    var fixedElement = toNormalJSON(currentElement);
                    res[key].push(fixedElement);
                }
            }
            else if (value === 0)
            {
                var fixedElement = toNormalJSON(elements);
                res[key].push(fixedElement);
            }
        }
    }
    return finalres;
}
return toNormalJSON(XML);
$$;

Transact-SQL¶

クエリ¶

DECLARE @idoc INT, @doc VARCHAR(1000);  
SET @doc ='  
<ROOT>  
<Customer CustomerID="VINET" ContactName="Paul Henriot">  
   <Order CustomerID="VINET" EmployeeID="5" OrderDate="1996-07-04T00:00:00">  
      <OrderDetail OrderID="10248" ProductID="11" Quantity="12"/>  
      <OrderDetail OrderID="10248" ProductID="42" Quantity="10"/>  
   </Order>  
</Customer>  
<Customer CustomerID="LILAS" ContactName="Carlos Gonzlez">  
   <Order CustomerID="LILAS" EmployeeID="3" OrderDate="1996-08-16T00:00:00">  
      <OrderDetail OrderID="10283" ProductID="72" Quantity="3"/>  
   </Order>  
</Customer>  
</ROOT>';  

EXEC sp_xml_preparedocument @idoc OUTPUT, @doc;  
 
SELECT *  FROM OPENXML (@idoc, '/ROOT/Customer',1)  
WITH (CustomerID  VARCHAR(10), ContactName VARCHAR(20)); 

結果¶

CustomerID  | ContactName
----------------------------|
VINET     | Paul Henriot
LILAS     | Carlos Gonzlez

Snowflake¶

注釈

以下の例は、環境変数が256バイトのストレージしかサポートしておらず、 XML のデモコードがその制限を超えて使用しているため、ストアドプロシージャに分離しています。

クエリ¶

DECLARE
IDOC INT;
DOC VARCHAR(1000);
BlockResultSet RESULTSET;
BEGIN
DOC := '  
<ROOT>  
<Customer CustomerID="VINET" ContactName="Paul Henriot">  
   <Order CustomerID="VINET" EmployeeID="5" OrderDate="1996-07-04T00:00:00">  
      <OrderDetail OrderID="10248" ProductID="11" Quantity="12"/>  
      <OrderDetail OrderID="10248" ProductID="42" Quantity="10"/>  
   </Order>  
</Customer>  
<Customer CustomerID="LILAS" ContactName="Carlos Gonzlez">  
   <Order CustomerID="LILAS" EmployeeID="3" OrderDate="1996-08-16T00:00:00">  
      <OrderDetail OrderID="10283" ProductID="72" Quantity="3"/>  
   </Order>  
</Customer>  
</ROOT>';
!!!RESOLVE EWI!!! /*** SSC-EWI-TS0075 - TRANSLATION FOR BUILT-IN PROCEDURE 'sp_xml_preparedocument' IS NOT CURRENTLY SUPPORTED. ***/!!!

EXEC sp_xml_preparedocument :IDOC OUTPUT, :DOC;
BlockResultSet := (

SELECT
Left(value:Customer['@CustomerID'], '10') AS 'CustomerID',
Left(value:Customer['@ContactName'], '20') AS 'ContactName'
FROM
OPENXML_UDF(:IDOC, ':ROOT:Customer'));
RETURN TABLE(BlockResultSet);
END;

結果¶


CustomerID	ContactName
VINET	Paul Henriot
LILAS	Carlos Gonzlez

クエリ¶

SET code = '<ROOT>  
<Customer CustomerID="VINET" ContactName="Paul Henriot">  
   <Order CustomerID="VINET" EmployeeID="5" OrderDate="1996-07-04T00:00:00">  
      <OrderDetail OrderID="10248" ProductID="11" Quantity="12"/>  
   </Order>  
</Customer>  
</ROOT>';
SELECT
Left(value:Customer['@CustomerID'],10) as "CustomerID",  
Left(value:Customer['@ContactName'],20) as "ContactName"
FROM TABLE(OPENXML_UDF($code,'ROOT:Customer'));

結果¶


CustomerID	ContactName
VINET	Paul Henriot

既知の問題¶

問題は見つかりませんでした。

STR UDF¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

このカスタム UDF は、数値データを文字データに変換します。

カスタム UDF オーバーロード¶

パラメーター¶

FLOAT_EXPR: varcharに変換する数値式。
FORMAT: 結果のvarcharの長さと小数点数を指定したvarchar式。この形式は SnowConvert で自動的に生成されます。

UDF¶

 CREATE OR REPLACE FUNCTION PUBLIC.STR_UDF(FLOAT_EXPR FLOAT, FORMAT VARCHAR)
RETURNS VARCHAR
LANGUAGE SQL
IMMUTABLE
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"udf"}}'
AS
$$
    TRIM(TRIM(SELECT TO_CHAR(FLOAT_EXPR, FORMAT)), '.')
$$;

CREATE OR REPLACE FUNCTION PUBLIC.STR_UDF(FLOAT_EXPR FLOAT)
RETURNS VARCHAR
LANGUAGE SQL
IMMUTABLE
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"udf"}}'
AS
$$
    STR_UDF(FLOAT_EXPR, '999999999999999999')
$$;

Transact-SQL¶

クエリ¶

SELECT
    STR(123.5) as A,
    STR(123.5, 2) as B,
    STR(123.45, 6) as C,
    STR(123.45, 6, 1) as D;

結果¶


A	B	C	D
124	**	123	123.5

Snowflake¶

クエリ¶

SELECT
    PUBLIC.STR_UDF(123.5, '99999') as A,
    PUBLIC.STR_UDF(123.5, '99') as B,
    PUBLIC.STR_UDF(123.45, '999999') as C,
    PUBLIC.STR_UDF(123.45, '9999.9') as D;

SWITCHOFFSET_UDF¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

このカスタム UDF は、保存されたタイムゾーンオフセットから指定された新しいタイムゾーンオフセットに変更されたdatetimeoffset値を返すために追加されます。

カスタム UDF オーバーロード¶

パラメーター

source_timestamp: datetimeoffset(n)値に解決できる TIMESTAMP_TZ。
target_tz: タイムゾーンオフセットを表すvarchar

UDF¶

CREATE OR REPLACE FUNCTION PUBLIC.SWITCHOFFSET_UDF(source_timestamp TIMESTAMP_TZ, target_tz varchar)
RETURNS TIMESTAMP_TZ
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"udf"}}'
AS 
$$
WITH tz_values AS (
SELECT 
    RIGHT(source_timestamp::varchar, 5) as source_tz,
    
    REPLACE(source_tz::varchar, ':', '') as source_tz_clean,
    REPLACE(target_tz::varchar, ':', '') as target_tz_clean,
    
    target_tz_clean::integer - source_tz_clean::integer as offset,
    
    RIGHT(offset::varchar, 2) as tz_min,
    PUBLIC.OFFSET_FORMATTER(RTRIM(offset::varchar, tz_min)) as tz_hrs,
    
    
    TIMEADD( hours, tz_hrs::integer, source_timestamp ) as adj_hours,
    TIMEADD( minutes, (LEFT(tz_hrs, 1) || tz_min)::integer, adj_hours::timestamp_tz ) as new_timestamp
    
FROM DUAL)
SELECT 
    (LEFT(new_timestamp, 24) || ' ' || target_tz)::timestamp_tz
FROM tz_values
$$;

-- ==========================================================================
-- Description: The function OFFSET_FORMATTER(offset_hrs varchar) serves as
-- an auxiliary function to format the offset hours and its prefix operator.
-- ==========================================================================  
CREATE OR REPLACE FUNCTION PUBLIC.OFFSET_FORMATTER(offset_hrs varchar)
RETURNS varchar
LANGUAGE SQL
COMMENT = '{"origin":"sf_sc","name":"snowconvert","version":{"major":1, "minor":0},"attributes":{"component":"udf"}}'
AS
$$
CASE
   WHEN LEN(offset_hrs) = 0 THEN '+' || '0' || '0'
   WHEN LEN(offset_hrs) = 1 THEN '+' || '0' || offset_hrs
   WHEN LEN(offset_hrs) = 2 THEN
        CASE 
            WHEN LEFT(offset_hrs, 1) = '-' THEN '-' || '0' || RIGHT(offset_hrs, 1)
            ELSE '+' || offset_hrs
        END
    ELSE offset_hrs
END
$$;

Transact-SQL¶

クエリ¶

SELECT 
  '1998-09-20 7:45:50.71345 +02:00' as fr_time,
  SWITCHOFFSET('1998-09-20 7:45:50.71345 +02:00', '-06:00') as cr_time;  

結果¶

SELECT 
  '1998-09-20 7:45:50.71345 +02:00' as fr_time,
  SWITCHOFFSET('1998-09-20 7:45:50.71345 +02:00', '-06:00') as cr_time;  

Snowflake¶

クエリ¶

SELECT
  '1998-09-20 7:45:50.71345 +02:00' as fr_time,
  PUBLIC.SWITCHOFFSET_UDF('1998-09-20 7:45:50.71345 +02:00', '-06:00') as cr_time;

結果¶


fr_time	cr_time
1998-09-20 7:45:50.71345 +02:00	1998-09-19 23:45:50.7134500 -06:00

メタデータ関数¶

This section describes the functional equivalents of metadata functions in Transact-SQL to Snowflake SQL and JavaScript code, oriented to their usage in stored procedures in Snowflake.

DB_NAME¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は指定されたデータベースの名前を返します。(Transact-SQL の DB_NAME)。

サンプルソースパターン¶

構文¶

SQL Server¶

 DB_NAME ( [ database_id ] )  

Snowflake SQL¶

 CURRENT_DATABASE() /*** SSC-FDM-TS0010 - CURRENT_DATABASE function has different behavior in certain cases ***/

例¶

SQL Server¶

SELECT DB_NAME();

結果:


RESULT
ADVENTUREWORKS2019

Snowflake SQL¶

SELECT
CURRENT_DATABASE() /*** SSC-FDM-TS0010 - CURRENT_DATABASE function has different behavior in certain cases ***/;

結果:


RESULT
ADVENTUREWORKS2019

既知の問題¶

1.CURRENT_DATABASE 関数は特定のケースで動作が異なります

DB_NAME function can be invoked with the database_id parameter, which returns the name of the specified database. Without parameters, the function returns the current database name. However, Snowflake does not support this parameter and the CURRENT_DATABASE function will always return the current database name.

OBJECT_ID¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数はスキーマスコープオブジェクトのデータベースオブジェクト識別番号を返します。(Transact-SQL の OBJECT_ID)。

SQL Server構文¶

 OBJECT_ID ( '[ database_name . [ schema_name ] . | schema_name . ]   
  object_name' [ ,'object_type' ] )

サンプルソースパターン¶

1.デフォルトの変換¶

SQL Server¶

 IF OBJECT_ID_UDF('DATABASE2.DBO.TABLE1') is not null) THEN
            DROP TABLE IF EXISTS TABLE1;
        END IF;

Snowflake SQL¶

 BEGIN
-- ** SSC-EWI-0001 - UNRECOGNIZED TOKEN ON LINE '1' COLUMN '0' OF THE SOURCE CODE STARTING AT 'IF'. EXPECTED 'If Statement' GRAMMAR. LAST MATCHING TOKEN WAS 'null' ON LINE '1' COLUMN '48'. FAILED TOKEN WAS ')' ON LINE '1' COLUMN '52'. CODE '70'. **
--IF OBJECT_ID_UDF('DATABASE2.DBO.TABLE1') is not null) THEN
--** SSC-FDM-0007 - MISSING DEPENDENT OBJECT "TABLE1" **
DROP TABLE IF EXISTS TABLE1;
END;

2.不明なデータベース¶

SQL Server¶

 IF OBJECT_ID_UDF('DATABASE1.DBO.TABLE1') is not null) THEN
            DROP TABLE IF EXISTS TABLE1;
        END IF;

Snowflake SQL¶

  IF (
 OBJECT_ID_UDF('DATABASE1.DBO.TABLE1') is not null) THEN
     DROP TABLE IF EXISTS TABLE1;
 END IF;

3.異なるオブジェクト名¶

SQL Server¶

 IF OBJECT_ID_UDF('DATABASE1.DBO.TABLE2') is not null) THEN
            DROP TABLE IF EXISTS TABLE1;
        END IF;

Snowflake SQL¶

  IF (
 OBJECT_ID_UDF('DATABASE1.DBO.TABLE2') is not null) THEN
     DROP TABLE IF EXISTS TABLE1;
 END IF;

既知の問題¶

1.OBJECT_ID_UDF 関数は特定のケースで動作が異なります

OBJECT_ID はオブジェクト識別番号を返しますが、 OBJECT_ID_UDF はブール値を返すため、 OBJECT_ID がnullでない条件で使用される場合にのみそれらは同等になります。

分析関数¶

このセクションでは、Transact-SQL の分析関数とSnowflake SQL および JavaScript コードの同等の機能について、Snowflakeでの UDFs の作成に焦点を当てて説明します。

LAG¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

SQL Server 2012（11.x）から始まる自己結合を使用せずに、同じ結果セット内の前の行のデータにアクセスします。 LAG は現在の行の前にある、任意の物理オフセットの行へのアクセスを提供します。現在の行の値と前の行の値を比較するには、 SELECT ステートメントでこの分析関数を使用します。（ Transact-SQL における COUNT ）。

サンプルソースパターン¶

構文¶

SQL Server¶

LAG (scalar_expression [,offset] [,default])  
    OVER ( [ partition_by_clause ] order_by_clause )  

Snowflake SQL¶

COUNT( [ DISTINCT ] <expr1> [ , <expr2> ... ] )

例¶

SQL Server¶

SELECT TOP 10 
LAG(E.VacationHours,1) OVER(ORDER BY E.NationalIdNumber) as PREVIOUS,
E.VacationHours AS ACTUAL 
FROM HumanResources.Employee E

結果:


PREVIOUS	ACTUAL
NULL	10
10	89
89	10
10	48
48	0
0	95
95	55
55	67
67	84
84	85

Snowflake SQL¶

SELECT TOP 10
LAG(E.VacationHours,1) OVER(ORDER BY E.NationalIdNumber) as PREVIOUS,
E.VacationHours AS ACTUAL
FROM
HumanResources.Employee E;

結果:


PREVIOUS	ACTUAL
NULL	10
10	89
89	10
10	48
48	0
0	95
95	55
55	67
67	84
84	85

データ型関数¶

このセクションでは、Transact-SQL とSnowflake SQL および JavaScript コードでのデータ型関数の相当する機能を説明します。

DATALENGTH¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、任意の式を表現するために使用されるバイト数を返します。(Transact-SQL の DATALENGTH)。

サンプルソースパターン¶

構文¶

SQL Server¶

DATALENGTH ( expression )   

Snowflake SQL¶

OCTET_LENGTH(<string_or_binary>)

例¶

SQL Server¶

SELECT DATALENGTH('SomeString') AS SIZE;

結果:


SIZE
10

Snowflake SQL¶

SELECT OCTET_LENGTH('SomeString') AS SIZE;

結果:


SIZE
10

数学関数¶

This section describes the functional equivalents of mathematical functions in Transact-SQL to Snowflake SQL and JavaScript code, oriented to their usage in stored procedures in Snowflake.

ABS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された数値式の絶対値（正の値）を返す数学関数。（ABS は負の値を正の値に変更します。ABS はゼロまたは正の値には影響しません。） (Transact-SQL の ABS)。

サンプルソースパターン¶

構文¶

SQL Server¶

ABS( expression )

Snowflake SQL¶

ABS( <num_expr> )

JavaScript¶

Math.abs( expression )

例¶

SQL Server¶

SELECT ABS(-5);

結果:


ABS(-5)
5

Snowflake SQL¶

SELECT ABS(-5);

結果:


ABS(-5)
5

JavaScript¶

CREATE OR REPLACE FUNCTION compute_abs(a float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  return Math.abs(A);
$$
;
SELECT COMPUTE_ABS(-5);

結果:


COMPUTE_ABS(-5)
5

AVG¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

注釈

SnowConvert AI ヘルパーコードセクションは省略されます。

この関数は、グループ内の値の平均を返します。null値は無視されます。(Transact-SQL の AVG)。

サンプルソースパターン¶

構文¶

SQL Server¶

AVG ( [ ALL | DISTINCT ] expression )  
   [ OVER ( [ partition_by_clause ] order_by_clause ) ]

Snowflake SQL¶

AVG( [ DISTINCT ] <expr1> )

AVG( [ DISTINCT ] <expr1> ) OVER (
                                 [ PARTITION BY <expr2> ]
                                 [ ORDER BY <expr3> [ ASC | DESC ] [ <window_frame> ] ]
                                 )

例¶

SQL Server¶

SELECT AVG(VACATIONHOURS) AS AVG_VACATIONS FROM HUMANRESOURCES.EMPLOYEE;

結果:


AVG_VACATIONS
50

Snowflake SQL¶

SELECT AVG(VACATIONHOURS) AS AVG_VACATIONS FROM HUMANRESOURCES.EMPLOYEE;

結果:


AVG_VACATIONS
50

CEILING¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた数値より大きい/等しい、最も小さい整数を返す数学関数(Transact-SQL の CEILING)。

サンプルソースパターン¶

構文¶

SQL Server¶

CEILING( expression )

Snowflake SQL¶

CEIL( <input_expr> [, <scale_expr> ] )

JavaScript¶

 Math.ceil( expression )

例¶

SQL Server¶

SELECT CEILING(642.20);

結果:


CEILING(642.20)
643

Snowflake SQL¶

SELECT CEIL(642.20);

結果:


CEIL(642.20)
643

JavaScript¶

CREATE OR REPLACE FUNCTION compute_ceil(a double)
RETURNS double
LANGUAGE JAVASCRIPT
AS
$$
  return Math.ceil(A);
$$
;
SELECT COMPUTE_CEIL(642.20);

結果:

COMPUTE_CEIL(642.20)|
--------------------|
                 643|

FLOOR¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された数値式以下の最大の整数を返します。(Transact-SQL の FLOOR)。

サンプルソースパターン¶

構文¶

SQL Server¶

FLOOR ( numeric_expression )  

Snowflake SQL¶

FLOOR( <input_expr> [, <scale_expr> ] )

例¶

SQL Server¶

SELECT FLOOR (124.87) AS FLOOR;

結果:

FLOOR|
-----|
  124|

Snowflake SQL¶

SELECT FLOOR (124.87) AS FLOOR;

結果:

FLOOR|
-----|
  124|

POWER¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された式の値を指定された累乗で返します。(Transact-SQL の POWER)。

サンプルソースパターン¶

構文¶

SQL Server¶

POWER ( float_expression , y )  

Snowflake SQL¶

POW(x, y)

POWER (x, y)

例¶

SQL Server¶

SELECT POWER(2, 10.0) AS IntegerResult

結果:

IntegerResult |
--------------|
          1024|

Snowflake SQL¶

SELECT POWER(2, 10.0) AS IntegerResult;

結果:

IntegerResult |
--------------|
          1024|

ROUND¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された長さまたは精度で丸められた数値を返します。(Transact-SQL の ROUND)。

サンプルソースパターン¶

構文¶

SQL Server¶

ROUND ( numeric_expression , length [ ,function ] )  

Snowflake SQL¶

ROUND( <input_expr> [, <scale_expr> ] )

例¶

SQL Server¶

SELECT ROUND(123.9994, 3) AS COL1, ROUND(123.9995, 3) AS COL2;  

結果:

COL1    |COL2    |
--------|--------|
123.9990|124.0000|

Snowflake SQL¶

SELECT ROUND(123.9994, 3) AS COL1,
ROUND(123.9995, 3) AS COL2;

結果:

COL1   | COL2  |
--------|------|
123.999|124.000|

SQRT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された浮動小数点値の平方根を返します。(Transact-SQL の SQRT)。

サンプルソースパターン¶

構文¶

SQL Server¶

SQRT ( float_expression )  

Snowflake SQL¶

SQRT(expr)

例¶

SQL Server¶

SELECT SQRT(25) AS RESULT;

結果:

RESULT|
------|
   5.0|

Snowflake SQL¶

SELECT SQRT(25) AS RESULT;

結果:

RESULT|
------|
   5.0|

SQUARE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された浮動小数点値の平方を返します。(Transact-SQL の SQUARE)。

サンプルソースパターン¶

構文¶

SQL Server¶

SQUARE ( float_expression )  ****

Snowflake SQL¶

SQUARE(expr)

例¶

SQL Server¶

SELECT SQUARE (5) AS SQUARE;

結果:

SQUARE|
------|
  25.0|

Snowflake SQL¶

SELECT SQUARE (5) AS SQUARE;

結果:

SQUARE|
------|
    25|

STDEV¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

指定された式のすべての値の統計標準偏差を返します。(Transact-SQL の STDEV)。

サンプルソースパターン¶

構文¶

SQL Server¶

 STDEV ( [ ALL | DISTINCT ] expression )  

Snowflake SQL¶

 STDDEV( [ DISTINCT ] <expression_1> )

例¶

SQL Server¶

SELECT
    STDEV(VACATIONHOURS)
FROM
    HUMANRESOURCES.EMPLOYEE AS STDEV;

結果:

           STDEV|
----------------|
28.7862150320948|

Snowflake SQL¶

SELECT
    STDDEV(VACATIONHOURS)
FROM
    HUMANRESOURCES.EMPLOYEE AS STDEV;

結果:

       STDEV|
------------|
28.786215034|

STDEVP¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

指定された式のすべての値に対する母集団の統計標準偏差を返します。(Transact-SQL の STDVEP)。

サンプルソースパターン¶

構文¶

SQL Server¶

STDEVP ( [ ALL | DISTINCT ] expression )  

Snowflake SQL¶

STDDEV_POP( [ DISTINCT ] expression_1)

例¶

SQL Server¶

SELECT
    STDEVP(VACATIONHOURS) AS STDEVP_VACATIONHOURS
FROM
    HumanResources.Employee;

結果:

STDEVP_VACATIONHOURS|
--------------------|
  28.736540767245085|

Snowflake SQL¶

SELECT
    STDDEV_POP(VACATIONHOURS) AS STDEVP_VACATIONHOURS
FROM
    HumanResources.Employee;

結果:

STDEVP_VACATIONHOURS|
--------------------|
        28.736540763|

VAR¶

Applies to

SQL Server
Azure Synapse Analytics

注釈

わかりやすくするため、出力コードの一部を省略しています。

説明¶

指定された式のすべての値の統計的分散を返します。(Transact-SQL の VAR)。

サンプルソースパターン¶

構文¶

SQL Server¶

VAR ( [ ALL | DISTINCT ] expression )  

Snowflake SQL¶

VAR_SAMP( [DISTINCT] <expr1> )

例¶

SQL Server¶

SELECT
    VAR(VACATIONHOURS)
FROM
    HUMANRESOURCES.EMPLOYEE AS VAR;

結果:

             VAR|
----------------|
28.7862150320948|

Snowflake SQL¶

SELECT
    VAR_SAMP(VACATIONHOURS)
FROM
    HUMANRESOURCES.EMPLOYEE AS VAR;

結果:

       VAR|
----------|
828.646176|

POWER¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された式の値を特定の累乗で返します。\ (Transact-SQL の POWER)。

サンプルソースパターン¶

構文¶

POWER( base, exp )

引数¶

base: 数値のベース。float式である必要があります。\ exp: 底上げする累乗。

返されるタイプ¶

戻り値の型は入力式に依存します。

Input Type	Return Type
float, real	float
decimal(p, s)	decimal(38, s)
int, smallint, tinyint	int
bigint	bigint
money, smallmoney	money
bit, char, nchar, varchar, nvarchar	float

例¶

クエリ¶

SELECT POWER(2, 3)

結果¶

POWER(2, 3)|
-----------|
        8.0|

JS の POW¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指数累乗のベースを返します。\ (JavaScript POW 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.pow( base, exp )

引数¶

base: 数値のベース。float式である必要があります。\ exp: 底上げする累乗。

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION compute_pow(base float, exp float)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
    return Math.pow(BASE, EXP);
$$
;
SELECT COMPUTE_POW(2, 3);

結果¶

COMPUTE_POW(2, 3)|
-----------------|
                8|

ACOS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた数値のラジアン単位のアークコサインを返す関数(Transact-SQL の ACOS)。

数学的には、アークコサインはコサインの逆関数であり、次のように定義されます:\ $$y = cos^{-1} \Leftrightarrow x = cos(y)$$

For $$y = cos^{-1}(x)$$:
- Range: $$0\leqslant y \leqslant \pi$$ or $$0^{\circ}\leqslant y \leqslant 180^{\circ}$$
- Domain: $$-1\leqslant x \leqslant 1$$

サンプルソースパターン¶

構文¶

ACOS ( expression )

引数¶

expression: 数値の float 式。式は$$[-1,1]$$内にあります。

返されるタイプ¶

0～πの数値float式。パラメーターで送られた数値式が$$[-1, 1]$$の領域外である場合、データベースエンジンはエラーを投げます。

例¶

クエリ¶

SELECT ACOS(-1.0);

結果¶

ACOS(-1.0)       |
-----------------|
3.141592653589793|

JS の ACOS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定した数値のアークコサインを返す関数\ (JavaScript ACOS 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.acos( expression )

引数¶

expression: 数値式。式は$$[-1,1]$$内にあります。

返されるタイプ¶

0～πの数値式。パラメーターで送られた数値式がラジアン単位のアークコサイン$$[-1, 1]$$の範囲外の場合、関数は NaN を返します。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION compute_acos(a double)
  RETURNS double
  LANGUAGE JAVASCRIPT
AS
$$
  return Math.acos(A);
$$
;
SELECT COMPUTE_ACOS(-1);

結果¶

COMPUTE_ACOS(-1)|
---------------|
    3.141592654|

ASIN¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた数値のラジアン単位のアークサインを返す関数(Transact-SQL の ASIN)。

アークサインはサインの逆関数であり、次の定義にまとめられます:\ $$y = sin^{-1} \Leftrightarrow x = sin(x)$$

For $$y = sin^{-1}(x)$$:\ - Range: $$-\frac{\pi}{2}\leqslant y \leqslant \frac{\pi}{2}$$ or $$-90^{\circ}\leqslant y \leqslant 90^{\circ}$$\ - Domain: $$-1\leqslant x \leqslant 1$$

サンプルソースパターン¶

構文¶

ASIN( expression )

引数¶

expression: 数値の float 式。式は$$[-1,1]$$内にあります。

返されるタイプ¶

$$-\frac{\pi}{2}$$と$$\frac{\pi}{2}$$の間の数値float式。パラメーターで送られた数値式が$$[-1, 1]$$に含まれない場合、データベースエンジンはエラーを投げます。

例¶

クエリ¶

SELECT ASIN(0.5);

結果¶

ASIN(0.5)         |
------------------|
0.5235987755982989|

JS の ASIN¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定した数値のアークサインを返す関数\ (JavaScript ASIN 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.asin( expression )

引数¶

expression: 数値式。式は$$[-1,1]$$内にあります。

返されるタイプ¶

$$-\frac{\pi}{2}$$と$$\frac{\pi}{2}$$の間の数値式。パラメーターで送られた数値式がアークコサイン$$[-1, 1]$$の領域外の場合、関数は NaN を返します。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION compute_asin(a float)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
  return Math.asin(A);
$$
;
SELECT COMPUTE_ASIN(0.5);

結果¶

COMPUTE_ASIN(1)   |
------------------|
      0.5235987756|

COS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターを通して送られた角度のコサインを返す関数（ラジアンで測定する必要があります） (Transact-SQL の COS)。

コサインは次のように定義されます:\ $$y = cos(x)$$\ Where:\ - Range: $$-1\leqslant y \leqslant 1$$\ - Domain: $$\mathbb{R}$$

サンプルソースパターン¶

構文¶

COS( expression )

引数¶

expression: 数値の float 式。式は$$\mathbb{R}$$内にあります。

返されるタイプ¶

$$[-1, 1]$$の数値float式。

例¶

クエリ¶

SELECT COS(PI())

結果¶

COS(PI())|
---------|
     -1.0|

JS の COS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

角度のコサインをラジアン単位で返す静的関数\ (JavaScript COS 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.cos( expression )

引数¶

expression: 数値式。

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

CREATE OR REPLACE FUNCTION compute_cos(angle float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  return Math.cos(ANGLE); 
$$
;
SELECT COMPUTE_COS(PI());

結果¶

COMPUTE_COS(PI())|
-----------------|
               -1|

COT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターを通して送られたラジアン単位の角度のコタンジェントを返します(Transact-SQL の COT)。

コサインは次のように定義されます:\ $$cot(x) = \frac{cos(x)}{sin(x)}$$または$$cot(x) = \frac{1}{tan(x)}$$\ コサインを計算するには、パラメーターがサイン関数とコサイン関数の制約に準拠する必要があります。

サンプルソースパターン¶

構文¶

COT( expression )

引数¶

expression: 数値の float 式。式は$$\mathbb{R}-{sin(expression)=0 \wedge tan(expression) =0}$$内にあります。

返されるタイプ¶

$$\mathbb{R}$$の数値float式。

例¶

クエリ¶

SELECT COT(1)

結果¶

COT(1)            |
------------------|
0.6420926159343306|

JS の COT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

残念ながら、 JavaScript のオブジェクト Math は、与えられた角度のコタンジェントを計算する方法を提供していません。\ これは、次の式を使用して計算できます: $$cot(x) = \frac{cos(x)}{sin(x)}$$

サンプルソースパターン¶

実装例¶

 function cot(angle){
    return Math.cos(angle)/Math.sin(angle);
}

引数¶

angle: ラジアン単位の数値式。

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

CREATE OR REPLACE FUNCTION compute_cot(angle float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  function cot(angle){
    return Math.cos(angle)/Math.sin(angle);
  }
  return cot(ANGLE);
    
$$
;
SELECT COMPUTE_COT(1);

結果¶

COMPUTE_COT(1);   |
------------------|
0.6420926159343308|

RADIANS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

度をラジアンに変換します。\ (Transact-SQL の RADIANS)。

サンプルソースパターン¶

構文¶

RADIANS( expression )

引数¶

expression: 度単位での数値式。

返されるタイプ¶

パラメーターを通してラジアン単位の数値式として送られる同じデータ型。

例¶

クエリ¶

SELECT RADIANS(180.0)

結果¶


RADIANS(180)
3.141592653589793116

注釈

この関数のパラメーターをfloatにキャストします。そうしないと、上記のステートメントは PI の値の代わりに3を返します。

JS の RADIANS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

JavaScript は、度を特定の角度のラジアンに変換する方法を提供していません。\ これは、次の式を使用して計算できます。$$Radians = \frac{\pi}{180^{\circ}} \cdot angle$$

サンプルソースパターン¶

実装例¶

 function radians(angle){
    return (Math.PI/180) * angle;
}

引数¶

angle: 度単位でのFloat式。

返されるタイプ¶

パラメーターを通してラジアン単位の数値式として送られる同じデータ型。

例¶

クエリ¶

CREATE OR REPLACE FUNCTION RADIANS(angle float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
    function radians(angle){
      return (Math.PI/180) * angle;
    }
    return radians(ANGLE);
$$
;
SELECT RADIANS(180);

結果¶


RADIANS(180)
3.141592654

PI¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

PI の定数値を返します\ (Transact-SQL の PI)。

サンプルソースパターン¶

構文¶

PI( )

引数¶

このメソッドはパラメーターを受け取りません。

返されるタイプ¶

Float。

例¶

クエリ¶

CREATE PROCEDURE CIRCUMFERENCE @radius float
AS 
    SELECT 2 * PI() * @radius;
GO:

EXEC CIRCUMFERENCE @radius = 2;

結果¶

CIRCUMFERENCE @radius = 2 |
--------------------------|
          12.5663706143592|

JS の PI¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

PI 数（約3.141592...）を表す定数\ (JavaScript PI ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.PI

例¶

クエリ¶

CREATE OR REPLACE FUNCTION circumference(radius float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  function circumference(r){
    return 2 * Math.PI * r;
  }
  return circumference(RADIUS); 
$$
;
SELECT CIRCUMFERENCE(2);

結果¶

  CIRCUMFERENCE(2)|
------------------|
12.566370614359172|

DEGREES¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターを通して送られたラジアン単位の角度を度数に変換します(Transact-SQL の DEGREES)。

サンプルソースパターン¶

構文¶

DEGREES( expression )

引数¶

expression: ラジアン単位の数値 float 式。

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

SELECT DEGREES(PI())

結果¶

DEGREES(PI())|
-------------|
        180.0|

JS の DEGREES¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

JavaScript は、ラジアンを特定の角度の度数に変換する方法を提供していません。これは、次の式を使用して計算できます。$$Degrees = \frac{180^{\circ}}{\pi} \cdot angle$$

サンプルソースパターン¶

実装例¶

 function degress(angle){
    return (180/Math.PI) * angle;
}

引数¶

angle: ラジアン単位の数値式。

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

CREATE OR REPLACE FUNCTION compute_degrees(angle float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  function degrees(angle){
    return (180/Math.PI) * angle;
  }
  return degrees(ANGLE);
    
$$
;
SELECT COMPUTE_DEGREES(PI());

結果¶

COMPUTE_DEGREES(PI())|
---------------------|
                180.0|

LOG¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

数値の自然対数を返します\ (Transact-SQL の LOG)。

サンプルソースパターン¶

構文¶

LOG( expression [, base ] )

引数¶

expression: 数値式。

base （オプション）: 数値の対数を計算するためのベース。デフォルトはオイラーです。

返されるタイプ¶

Float。

例¶

クエリ¶

SELECT LOG(8, 2)

結果¶

LOG(8, 2)  |
-----------|
          3|

JS の LOG¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

オイラー数をベースとして対数を返します。(JavaScript LOG 関数ドキュメント)。

警告

残念ながら、 JavaScript はパラメーターを通して対数のベースを受け取るメソッドを提供していませんが、これはベースを引数で割ることで解決できます。

サンプルソースパターン¶

構文¶

 Math.log( expression )

引数¶

expression: 数値式。正の値である必要があります。それ以外の場合は NaN を返します。\

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION base_log(base float, exp float)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
  function getBaseLog(x, y){
    return Math.log(y)/Math.log(x);
  }
  return getBaseLog(EXP, BASE)
$$
;
SELECT BASE_LOG(2, 8);

結果¶

BASE_LOG(2, 8)|
--------------|
             3|

ATAN¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた数値のラジアン単位のアークタンジェントを返す関数(Transact-SQL の ATAN)。

アークタンジェントはタンジェントの逆関数であり、次の定義にまとめられます:\ $$y = arctan^{-1} \Leftrightarrow x = tan(x)$$

For $$y = tan^{-1}(x)$$:\ - Range: $$-\frac{\pi}{2}\leqslant y \leqslant \frac{\pi}{2}$$ or $$-90^{\circ}\leqslant y \leqslant 90^{\circ}$$\ - Domain: $$\mathbb{R}$$

サンプルソースパターン¶

構文¶

ATAN( expression )

引数¶

expression: 数値 float 式、またはfloatに変換可能な数値型。

返されるタイプ¶

$$-\frac{\pi}{2}$$と$$\frac{\pi}{2}$$の間の数値float式。

例¶

クエリ¶

SELECT ATAN(-30);

結果¶

ATAN(-30)          |
-------------------|
-1.5374753309166493|

JS の ATAN¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定した数値のアークタンジェントを返す関数\ (JavaScript ATAN 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.atan( expression )

引数¶

expression: 数値式。

返されるタイプ¶

$$-\frac{\pi}{2}$$と$$\frac{\pi}{2}$$の間の数値式。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION compute_atan(a float)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
  return Math.atan(A);
$$
;
SELECT COMPUTE_ATAN(-30);

結果¶

COMPUTE_ATAN(-30)|
-----------------|
     -1.537475331|

ATN2¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

パラメーターとして送られた2つの座標のラジアン単位のアークタンジェントを返す関数(Transact-SQL の ATN2)。

For $$z = tan^{-1}(x, y)$$:
- Range: $$-\pi\leqslant z \leqslant \pi$$ or $$-180^{\circ}\leqslant z \leqslant 180^{\circ}$$
- Domain: $$\mathbb{R}$$

サンプルソースパターン¶

構文¶

ATN2( expression_1, expression_2 )

引数¶

expression1 および expression2: 数値式。

返されるタイプ¶

$$-\pi$$と$$\pi$$の間の数値式。

例¶

クエリ¶

SELECT ATN2(7.5, 2);

結果¶

ATN2(7.5, 2)      |
------------------|
1.3101939350475555|

JS の ATAN2¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

2つのパラメーターのアークタンジェントを返す関数\ (JavaScript ATAN2 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.atan2( expression_1, expression_2 )

引数¶

expression_1 および expression_2: 数値式。

返されるタイプ¶

$$-\pi$$と$$\pi$$の間の数値式。

例¶

クエリ¶

CREATE OR REPLACE FUNCTION compute_atan2(x float, y float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  return Math.atan2(X, Y);
$$
;
SELECT COMPUTE_ATAN2(7.5, 2);

結果¶

ATAN2(7.5, 3)     |
------------------|
       1.310193935|

LOG10¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

数値のベースを10とする対数を返します\ (Transact-SQL の LOG10)。

サンプルソースパターン¶

構文¶

LOG10( expression )

引数¶

expression: 数値式。正でなければなりません。

返されるタイプ¶

Float。

例¶

クエリ¶

SELECT LOG10(5)

結果¶

LOG10(5)         |
-----------------|
0.698970004336019|

JS の LOG10¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

数値のベースを10とする対数を返します\ (JavaScript LOG10 関数ドキュメント)。

サンプルソースパターン¶

構文¶

 Math.log10( expression )

引数¶

expression: 数値式。正の値である必要があります。それ以外の場合は NaN を返します。\

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

 CREATE OR REPLACE FUNCTION compute_log10(argument float)
  RETURNS float
  LANGUAGE JAVASCRIPT
AS
$$
    return Math.log10(ARGUMENT);
$$
;
SELECT COMPUTE_LOG10(7.5);

結果¶

COMPUTE_LOG10(5)|
----------------|
    0.6989700043|

EXP¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

オイラーの指数値を返します(Transact-SQL の EXP)。

サンプルソースパターン¶

構文¶

EXP( expression )

引数¶

expression: 数値式。

返されるタイプ¶

パラメーターを通して数値式として送られる同じデータ型。

例¶

クエリ¶

SELECT EXP(LOG(20)), LOG(EXP(20))  
GO 

結果¶

EXP(LOG(20))   |LOG(EXP(20))    |
---------------|----------------|
           20.0|            20.0|

JS の EXP¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

オイラー数を表す定数（約2.718...）\ (JavaScript オイラー数のドキュメント)。\ JavaScript では、オイラーの指数のみをサポートするTransact-SQL の代わりに、この定数を使用してさまざまな操作を行うことができます。

サンプルソースパターン¶

構文¶

 Math.E

例¶

クエリ¶

CREATE OR REPLACE FUNCTION compute_exp(x float)
RETURNS float
LANGUAGE JAVASCRIPT
AS
$$
  return Math.E**X;
$$
;
SELECT COMPUTE_EXP(LN(20)), LN(COMPUTE_EXP(20));

結果¶

COMPUTE_EXP(LOG(20))|LOG(COMPUTE_EXP(20))|
--------------------|--------------------|
                20.0|                20.0|

変換関数¶

このセクションでは、Transact-SQL とSnowflake SQL コードでの日付と時刻の関数の相当する機能を説明します。

CONVERT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

あるデータ型の式を別のデータ型に変換します。(Transact-SQL の CONVERT)。

サンプルソースパターン¶

構文¶

SQL Server¶

CONVERT ( data_type [ ( length ) ] , expression [ , style ] )  

Snowflake SQL¶

(SQL Server言語リファレンス TRY_CONVERT)

CAST( <source_expr> AS <target_data_type> )

例¶

SQL Server¶

SELECT CONVERT(INT, '1998') as MyDate

結果¶


MyDate
1998

Snowflake SQL¶

SELECT
CAST('1998' AS INT) as MyDate;

結果¶


MYDATE
1998

日付型をvarcharにキャスト¶

SQL Server¶

SELECT CONVERT(varchar, getdate(), 1) AS RESULT;

結果¶


RESULT
12/08/22

Swowflake SQL¶

SELECT
TO_VARCHAR(CURRENT_TIMESTAMP() :: TIMESTAMP, 'mm/dd/yy') AS RESULT;

結果¶


RESULT
12/08/22

日付型をサイズ付きvarcharにキャスト¶

SQL Server¶

SELECT CONVERT(varchar(2), getdate(), 1) AS RESULT;

結果¶


RESULT
07

Snowflake SQL¶

SELECT
LEFT(TO_VARCHAR(CURRENT_TIMESTAMP() :: TIMESTAMP, 'mm/dd/yy'), 2) AS RESULT;

結果¶


RESULT
07

サポートされている日付キャストの形式は以下のとおりです。

日付形式


コード	形式
1	mm/dd/yy
2	yy.mm.dd
3	dd/mm/yy
4	dd.mm.yy
5	dd-mm-yy
6	dd-Mon-yy
7	Mon dd, yy
10	mm-dd-yy
11	yy/mm/dd
12	yymmdd
23	yyyy-mm-dd
101	mm/dd/yyyy
102	yyyy.mm.dd
103	dd/mm/yyyy
104	dd.mm.yyyy
105	dd-mm-yyyy
106	dd Mon yyyy
107	Mon dd, yyyy
110	mm-dd-yyyy
111	yyyy/mm/dd
112	yyyymmdd

時刻形式


コード	形式
8	hh:mm:ss
14	hh:mm:ss:ff3
24	hh:mm:ss
108	hh:mm:ss
114	hh:mm:ss:ff3

日付と時刻の形式



0	Mon dd yyyy hh:mm AM/PM
9	Mon dd yyyy hh:mm:ss:ff3 AM/PM
13	dd Mon yyyy hh:mm:ss:ff3 AM/PM
20	yyyy-mm-dd hh:mm:ss
21	yyyy-mm-dd hh:mm:ss:ff3
22	mm/dd/yy hh:mm:ss AM/PM
25	yyyy-mm-dd hh:mm:ss:ff3
100	Mon dd yyyy hh:mm AM/PM
109	Mon dd yyyy hh:mm:ss:ff3 AM/PM
113	dd Mon yyyy hh:mm:ss:ff3
120	yyyy-mm-dd hh:mm:ss
121	yyyy-mm-dd hh:mm:ss:ff3
126	yyyy-mm-dd T hh:mm:ss:ff3
127	yyyy-mm-dd T hh:mm:ss:ff3

イスラム暦の日付


コード	形式
130	dd mmm yyyy hh:mi:ss:ff3 AM/PM
131	dd mmm yyyy hh:mi:ss:ff3 AM/PM

現在のコードとパターンが一致しない場合は、 yyyy-mm-dd hh:mm:ss の形式になります。

Converting string to DATE or DATETIME with style¶

When CONVERT targets a DATE, DATETIME, or DATETIME2 type and includes a literal style code, SnowConvert AI maps it to TO_DATE or TO_TIMESTAMP with the corresponding Snowflake format string.

SQL Server¶

SELECT
    CONVERT(DATE, StartDate, 101) AS StartDt,
    CONVERT(DATE, EndDate, 103) AS EndDt,
    CONVERT(DATETIME, EventTime, 120) AS EventTs
FROM Events

Snowflake SQL¶

SELECT
  TO_DATE(StartDate, 'mm/dd/yyyy') AS StartDt,
  TO_DATE(EndDate, 'dd/mm/yyyy') AS EndDt,
  TO_TIMESTAMP(EventTime, 'yyyy-mm-dd hh:mm:ss') AS EventTs
FROM
  Events;

The following table shows which target types produce TO_DATE versus TO_TIMESTAMP:


Target Type	Snowflake Function
DATE	TO_DATE
DATETIME	TO_TIMESTAMP
DATETIME2	TO_TIMESTAMP

Converting VARBINARY / BINARY with style¶

When converting to VARBINARY or BINARY with a hex style (1 or 2), SnowConvert AI maps to TO_BINARY(expr, 'HEX'). Style 0 (default/ASCII) maps to a plain CAST. For VARBINARY(MAX), the outer CAST is omitted.

SQL Server¶

SELECT CONVERT(VARBINARY(16), @UGIDString, 0);
SELECT CONVERT(VARBINARY(16), @UGIDString, 1);
SELECT CONVERT(VARBINARY(MAX), @HexData, 2);
SELECT CONVERT(BINARY(16), @HexData, 1);

Snowflake SQL¶

SELECT CAST(@UGIDString AS VARBINARY(16));
SELECT CAST(TO_BINARY(@UGIDString, 'HEX') AS VARBINARY(16));
SELECT TO_BINARY(@HexData, 'HEX');
SELECT CAST(TO_BINARY(@HexData, 'HEX') AS BINARY(16));

Converting with a dynamic style variable¶

When the style argument is a variable or expression instead of a literal, SnowConvert AI cannot determine the format string at conversion time. The function falls back to CAST and emits SSC-EWI-TS0098.

SQL Server¶

SELECT CONVERT(DATE, @InputDate, @Style)

Snowflake SQL¶

SELECT
  !!!RESOLVE EWI!!! /*** SSC-EWI-TS0098 - CONVERT WITH A VARIABLE OR EXPRESSION AS THE STYLE ARGUMENT CANNOT BE AUTOMATICALLY MAPPED TO A SNOWFLAKE FORMAT STRING. REPLACE WITH THE APPROPRIATE TO_DATE/TO_TIMESTAMP CALL WITH THE KNOWN FORMAT STRING. ***/!!!
  CAST(@InputDate AS DATE);

TRY_CONVERT¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

キャストが成功した場合は、指定されたデータ型にキャストされた値を返します。それ以外の場合はnullを返します。

構文¶

TRY_CONVERT ( data_type [ ( length ) ], expression [, style ] )  

ソースパターン¶

基本的な変換¶

To transform this function, we have to check the parameters of the TRY_CONVERT first.

TRY_CONVERT( INT, 'test')

キャストする必要がある式が文字列の場合、Snowflakeの関数である TRY_CAST に変換されます。

TRY_CAST( 'test' AS INT)

TRY_CAST¶

TRY_CAST は TRY_CONVERT と同じ変換を共有します。

例¶

SQL Server¶

SELECT TRY_CAST('12345' AS NUMERIC) NUMERIC_RESULT,
 TRY_CAST('123.45' AS DECIMAL(20,2)) DECIMAL_RESULT,
 TRY_CAST('123' AS INT) INT_RESULT,
 TRY_CAST('123.02' AS FLOAT) FLOAT_RESULT,
 TRY_CAST('123.02' AS DOUBLE PRECISION) DOUBLE_PRECISION_RESULT,

 TRY_CAST('2017-01-01 12:00:00' AS DATE) DATE_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS DATETIME) DATETIME_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS SMALLDATETIME) SMALLDATETIME_RESULT,
 TRY_CAST('12:00:00' AS TIME) TIME_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS TIMESTAMP) TIMESTAMP_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS DATETIMEOFFSET) DATETIMEOFFSET_RESULT,

 TRY_CAST(1234 AS VARCHAR) VARCHAR_RESULT,
 TRY_CAST(1 AS CHAR) CHAR_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS SQL_VARIANT) SQL_VARIANT_RESULT,
 TRY_CAST('LINESTRING(-122.360 47.656, -122.343 47.656 )' AS GEOGRAPHY) GEOGRAPHY_RESULT;

結果は TRY_CONVERT の例と同じです。

Snowflake¶

SELECT
 TRY_CAST('12345' AS NUMERIC(38, 18)) NUMERIC_RESULT,
 TRY_CAST('123.45' AS DECIMAL(20,2)) DECIMAL_RESULT,
 TRY_CAST('123' AS INT) INT_RESULT,
 TRY_CAST('123.02' AS FLOAT) FLOAT_RESULT,
 TRY_CAST('123.02' AS DOUBLE PRECISION) DOUBLE_PRECISION_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS DATE) DATE_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS TIMESTAMP_NTZ(3)) DATETIME_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS TIMESTAMP_NTZ(0)) SMALLDATETIME_RESULT,
 TRY_CAST('12:00:00' AS TIME(7)) TIME_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS BINARY(8)) TIMESTAMP_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS TIMESTAMP_TZ(7)) DATETIMEOFFSET_RESULT,
 TO_VARCHAR(1234) VARCHAR_RESULT,
 TO_CHAR(1) CHAR_RESULT,
 TRY_CAST('2017-01-01 12:00:00' AS VARIANT) SQL_VARIANT_RESULT,
 TRY_CAST('LINESTRING(-122.360 47.656, -122.343 47.656 )' AS GEOGRAPHY) GEOGRAPHY_RESULT;

既知の問題¶

データ型がVarcharやCharの場合は、異なる変換が行われます。

TRY_CONVERT(VARCHAR, 1234);
TRY_CONVERT(CHAR, 1);

Snowflakeで TRY_CAST を VARCHAR や CHAR と一緒に使うとエラーになるので、次のように変換します。

TO_VARCHAR(1234);
TO_CHAR(1);

SQL_VARIANT と GEOGRAPHY のデータ型も同様です。

TRY_CONVERT(SQL_VARIANT, '2017-01-01 12:00:00');
TRY_CONVERT(GEOGRAPHY, 'LINESTRING(-122.360 47.656, -122.343 47.656 )');

以下に変換されます

TO_VARIANT('2017-01-01 12:00:00');
TO_GEOGRAPHY('LINESTRING(-122.360 47.656, -122.343 47.656 )');

式が文字列でない場合、Snowflakeの TRY_CAST は文字列式でのみ機能するため、失敗する可能性が非常に高くなります。

この場合、別の変換が行われます

TRY_CAST(14.85 AS INT)

以下に変換されます

CAST(14.85 AS INT) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/

さて、このような変換では、関数で何を行うかによって問題が発生する可能性があります。SqlServer の TRY୧_CONVERT は、変換できなかった場合はnullを返します。

これは、次のようなロジックを実行するために使用できます

SELECT 
    CASE
        WHEN TRY_CONVERT( INT, 'Expression') IS NULL
        THEN 'FAILED'
        ELSE 'SUCCEDDED'
    END;

TRY_CONVERT を含むこのタイプの条件は TRY_CAST で使用できますが、それを TO_VARCHAR、 TOCHAR、または CAST に変換するとどうなるでしょうか？これらの関数で変換に失敗した場合、nullを返す代わりにエラーを発生させます。

例¶

このサンプルでは、データ型が異なる TRY_CONVERT が複数あります

SQL Server¶

SELECT TRY_CONVERT(NUMERIC, '12345') NUMERIC_RESULT,
 TRY_CONVERT(DECIMAL(20,2), '123.45') DECIMAL_RESULT,
 TRY_CONVERT(INT, '123') INT_RESULT,
 TRY_CONVERT(FLOAT, '123.02') FLOAT_RESULT,
 TRY_CONVERT(DOUBLE PRECISION, '123.02') DOUBLE_PRECISION_RESULT,

 TRY_CONVERT(DATE, '2017-01-01 12:00:00') DATE_RESULT,
 TRY_CONVERT(DATETIME, '2017-01-01 12:00:00') DATETIME_RESULT,
 TRY_CONVERT(SMALLDATETIME, '2017-01-01 12:00:00') SMALLDATETIME_RESULT,
 TRY_CONVERT(TIME, '12:00:00') TIME_RESULT,
 TRY_CONVERT(TIMESTAMP, '2017-01-01 12:00:00') TIMESTAMP_RESULT,
 TRY_CONVERT(DATETIMEOFFSET, '2017-01-01 12:00:00') DATETIMEOFFSET_RESULT,

 TRY_CONVERT(VARCHAR, 1234) VARCHAR_RESULT,
 TRY_CONVERT(CHAR, 1) CHAR_RESULT,
 TRY_CONVERT(SQL_VARIANT, '2017-01-01 12:00:00') SQL_VARIANT_RESULT,
 TRY_CONVERT(GEOGRAPHY, 'LINESTRING(-122.360 47.656, -122.343 47.656 )') GEOGRAPHY_RESULT;

この選択を移行すると、次のような結果が得られます

Snowflake¶

SELECT
 CAST('12345' AS NUMERIC(38, 18)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ NUMERIC_RESULT,
 CAST('123.45' AS DECIMAL(20,2)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ DECIMAL_RESULT,
 CAST('123' AS INT) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ INT_RESULT,
 CAST('123.02' AS FLOAT) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ FLOAT_RESULT,
 CAST('123.02' AS DOUBLE PRECISION) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ DOUBLE_PRECISION_RESULT,
 CAST('2017-01-01 12:00:00' AS DATE) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ DATE_RESULT,
 CAST('2017-01-01 12:00:00' AS TIMESTAMP_NTZ(3)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ DATETIME_RESULT,
 CAST('2017-01-01 12:00:00' AS TIMESTAMP_NTZ(0)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ SMALLDATETIME_RESULT,
 CAST('12:00:00' AS TIME(7)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ TIME_RESULT,
 CAST('2017-01-01 12:00:00' AS BINARY(8)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ TIMESTAMP_RESULT,
 CAST('2017-01-01 12:00:00' AS TIMESTAMP_TZ(7)) /*** SSC-FDM-TS0005 - TRY_CONVERT/TRY_CAST COULD NOT BE CONVERTED TO TRY_CAST ***/ DATETIMEOFFSET_RESULT,
 TO_VARCHAR(1234) VARCHAR_RESULT,
 TO_CHAR(1) CHAR_RESULT,
 TO_VARIANT('2017-01-01 12:00:00') SQL_VARIANT_RESULT,
 TO_GEOGRAPHY('LINESTRING(-122.360 47.656, -122.343 47.656 )') GEOGRAPHY_RESULT;

それぞれを実行し、結果を比較してみましょう。


エイリアス	SqlServer 結果	Snowflake結果
NUMERIC_RESULT	12345	12345
DECIMAL_RESULT	123.45	123.45
INT_RESULT	123	123
FLOAT_RESULT	123.02	123.02
DOUBLE_PRECISION_RESULT	123.02	123.02
DATE_RESULT	2017-01-01	2017-01-01
DATETIME_RESULT	2017-01-01 12:00:00.000	2017-01-01 12:00:00.000
SMALLDATETIME_RESULT	2017-01-01 12:00:00	2017-01-01 12:00:00.000
TIME_RESULT	12:00:00.0000000	12:00:00
TIMESTAMP_RESULT	0x323031372D30312D	2017-01-01 12:00:00.000
DATETIMEOFFSET_RESULT	2017-01-01 12:00:00.0000000 +00:00	2017-01-01 12:00:00.000 -0800
VARCHAR_RESULT	1234	1234
CHAR_RESULT	1	1
SQL_VARIANT_RESULT	2017-01-01 12:00:00	"2017-01-01 12:00:00"
GEOGRAPHY_RESULT	0xE610000001148716D9CEF7D34740D7A3703D0A975EC08716D9CEF7D34740CBA145B6F3955EC0	{ "coordinates": [ [ -122.36, 47.656 ], [ -122.343, 47.656 ] ], "type": "LineString" }

日付と時刻の関数¶

このセクションでは、Transact-SQL とSnowflake SQL および JavaScript コードでの日付と時刻の関数の相当する機能を説明します。

AT TIME ZONE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

inputdate をターゲットタイムゾーンの対応する datetimeoffset 値に変換します。(Transact-SQL の AT TIME ZONE)。

サンプルソースパターン¶

構文¶

SQL Server¶

inputdate AT TIME ZONE timezone

Snowflake SQL¶

CONVERT_TIMEZONE( <source_tz> , <target_tz> , <source_timestamp_ntz> )

CONVERT_TIMEZONE( <target_tz> , <source_timestamp> )

例¶

SQL Server¶

SELECT CAST('2022-11-24 11:00:45.2000000 +00:00' as datetimeoffset) at time zone 'Alaskan Standard Time';

結果:

                          DATE|
------------------------------|
2022-11-24 02:00:45.200 -09:00|

Snowflake SQL¶

SELECT
CONVERT_TIMEZONE('America/Anchorage', CAST('2022-11-24 11:00:45.2000000 +00:00' as TIMESTAMP_TZ(7)));

結果:

                          DATE|
------------------------------|
2022-11-24 02:00:45.200 -09:00|

SQL Server¶

SELECT current_timestamp at time zone 'Central America Standard Time';

結果:

                          DATE|
------------------------------|
2022-10-10 10:55:50.090 -06:00|

Snowflake SQL¶

SELECT
CONVERT_TIMEZONE('America/Costa_Rica', CURRENT_TIMESTAMP() /*** SSC-FDM-TS0024 - CURRENT_TIMESTAMP in At Time Zone statement may have a different behavior in certain cases ***/);

結果:

                          DATE|
------------------------------|
2022-10-10 10:55:50.090 -06:00|

既知の問題¶

Snowflakeは、 SQL Serverがサポートしているすべてのタイムゾーンをサポートしていません。サポートされているタイムゾーンはこちらのリンクからご確認いただけます。

SQL Server¶

SELECT current_timestamp at time zone 'Turks And Caicos Standard Time';

結果:

                          DATE|
------------------------------|
2022-12-14 20:04:18.317 -05:00| 

Snowflake SQL¶

SELECT
!!!RESOLVE EWI!!! /*** SSC-EWI-TS0063 - TIME ZONE NOT SUPPORTED IN SNOWFLAKE ***/!!!
CURRENT_TIMESTAMP() at time zone 'Turks And Caicos Standard Time';

DATEADD¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定された日付の指定された日付部分を表す整数を返します。(Transact-SQL の DATEPART)。

サンプルソースパターン¶

構文¶

SQL Server¶

DATEADD (datepart , number , date )  

Snowflake SQL¶

DATEADD( <date_or_time_part>, <value>, <date_or_time_expr> )

例¶

SQL Server¶

SELECT DATEADD(year,123, '20060731') as ADDDATE;  

結果:

                 ADDDATE|
------------------------|
 2129-07-31 00:00:00.000|

Snowflake SQL¶

SELECT
DATEADD(year, 123, '20060731') as ADDDATE;

結果:

                 ADDDATE|
------------------------|
 2129-07-31 00:00:00.000|

DATEDIFF¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定された開始日と終了日の間に横切った指定された日付部分の境界の数を（符号付き整数値として）返します。(Transact-SQL の DATEDIFF)。

サンプルソースパターン¶

構文¶

SQL Server¶

DATEDIFF ( datepart , startdate , enddate )  

Snowflake SQL¶

DATEDIFF( <date_or_time_part>, <date_or_time_expr1>, <date_or_time_expr2> )

例¶

SQL Server¶

SELECT DATEDIFF(year,'2005-12-31 23:59:59.9999999', '2006-01-01 00:00:00.0000000');

結果:


DIFF
1

Snowflake SQL¶

SELECT DATEDIFF(year,'2005-12-31 23:59:59.9999999', '2006-01-01 00:00:00.0000000');

結果:


DIFF
1

DATEFROMPARTS¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定された年、月、日の値にマッピングされた日付の値を返します。(Transact-SQL の DATEFROMPARTS)。

サンプルソースパターン¶

構文¶

SQL Server¶

DATEFROMPARTS ( year, month, day )  

Snowflake SQL¶

DATE_FROM_PARTS( <year>, <month>, <day> )

例¶

SQL Server¶

SELECT DATEFROMPARTS ( 2010, 12, 31 ) AS RESULT;  

結果:


RESULT
2022-12-12

Snowflake SQL¶

SELECT DATE_FROM_PARTS ( 2010, 12, 31 ) AS RESULT;

結果:


RESULT
2022-12-12

DATENAME¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定された日付の指定された日付部分を表す文字列を返します。(Transact-SQL の DATENAME)。

サンプルソースパターン¶

構文¶

SQL Server¶

DATENAME ( datepart , date )  

Snowflake SQL¶

注釈

この変換は、入力に応じていくつかの関数を使用します

DATE_PART( <date_or_time_part> , <date_or_time_expr> )
MONTHNAME( <date_or_timestamp_expr> )
DAYNAME( <date_or_timestamp_expr> )

例¶

SQL Server¶

SELECT DATENAME(month, getdate()) AS DATE1,
DATENAME(day, getdate()) AS DATE2,
DATENAME(dw, GETDATE()) AS DATE3;

結果:


DATE1	DATE2	DATE3
May	3	Tuesday

Snowflake SQL¶

SELECT
MONTHNAME_UDF(CURRENT_TIMESTAMP() :: TIMESTAMP) AS DATE1,
DAYNAME_UDF(CURRENT_TIMESTAMP() :: TIMESTAMP) AS DATE2,
DAYNAME(CURRENT_TIMESTAMP() :: TIMESTAMP) AS DATE3;

結果:


DATE1	DATE2	DATE3
May	Tue	Tue

DATEPART¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定された日付の指定された日付部分を表す整数を返します。(Transact-SQL の DATEPART)。

サンプルソースパターン¶

構文¶

SQL Server¶

DATEPART ( datepart , date )  

Snowflake SQL¶

DATE_PART( <date_or_time_part> , <date_or_time_expr> )

例¶

SQL Server¶

SELECT DATEPART(YEAR, '10-10-2022') as YEAR

結果:


YEAR
2022

Snowflake SQL¶

SELECT
DATE_PART(YEAR, '10-10-2022' :: TIMESTAMP) as YEAR;

結果:


YEAR
2022

DAY¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定された日付の日（月内の日）を表す整数を返します。(Transact-SQL の DAY)。

サンプルソースパターン¶

構文¶

SQL Server¶

DAY ( date )  

Snowflake SQL¶

DAY( <date_or_timestamp_expr> )

例¶

SQL Server¶

SELECT DAY('10-10-2022') AS DAY

結果:


DAY
10

Snowflake SQL¶

SELECT DAY('10-10-2022' :: TIMESTAMP) AS DAY;

結果:


DAY
10

EOMONTH¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

この関数は、指定した日付を含む月の最終日を、オプションのオフセットを付けて返します。(Transact-SQL の EOMONTH)。

サンプルソースパターン¶

構文¶

SQL Server¶

EOMONTH ( start_date [, month_to_add ] )  

Snowflake SQL¶

LAST_DAY( <date_or_time_expr> [ , <date_part> ] )

例¶

SQL Server¶

SELECT EOMONTH (GETDATE()) AS Result; 

結果:


RESULT
2022-05-31

Snowflake SQL¶

SELECT
LAST_DAY(DATEADD('month', 0, CURRENT_TIMESTAMP() :: TIMESTAMP)) AS Result;

結果:


RESULT
2022-05-31

GETDATE¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

現在のデータベースシステムのタイムスタンプを、データベースタイムゾーンオフセットを除いた 日付時刻 値として返します。(Transact-SQL の GETDATE)。

サンプルソースパターン¶

構文¶

SQL Server¶

GETDATE() 

Snowflake SQL¶

CURRENT_TIMESTAMP( [ <fract_sec_precision> ] )

例¶

SQL Server¶

SELECT GETDATE() AS DATE;

結果:


DATE
2022-05-06 09:54:42.757

Snowflake SQL¶

SELECT CURRENT_TIMESTAMP() :: TIMESTAMP AS DATE;

結果:


DATE
2022-05-06 08:55:05.422

MONTH¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された日付の月を表す整数を返します。(Transact-SQL の MONTH)。

サンプルソースパターン¶

構文¶

SQL Server¶

MONTH( date )  

Snowflake SQL¶

MONTH ( <date_or_timestamp_expr> )

例¶

SQL Server¶

SELECT MONTH('10-10-2022') AS MONTH

結果:


MONTH
10

Snowflake SQL¶

SELECT MONTH('10-10-2022' :: TIMESTAMP) AS MONTH;

結果:


MONTH
10

SWITCHOFFSET¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

SWITCHOFFSET は、指定されたタイムスタンプ値を特定のタイムゾーンオフセットに調整します。これは数値によって行われます。詳細情報は SWITCHOFFSET (Transact-SQL)をご覧ください。

サンプルソースパターン¶

構文¶

UDF ヘルパーは、 SQLServer の SWITCHOFFSET 関数と同じ構文を共有し、機能的な等価性を達成します。

SQLServer¶

 SWITCHOFFSET ( datetimeoffset_expression, timezoneoffset_expression )   

Snowflake SQL¶

 SWITCHOFFSET_UDF ( timestamp_tz_expression, timezoneoffset_expression )   

例¶

SQLServer¶

SELECT
  '1998-09-20 7:45:50.71345 +02:00' as fr_time,
  SWITCHOFFSET('1998-09-20 7:45:50.71345 +02:00', '-06:00') as cr_time;  

結果:


fr_time	cr_time
1998-09-20 7:45:50.71345 +02:00	1998-09-19 23:45:50.7134500 -06:00

Snowflake SQL¶

SELECT
  '1998-09-20 7:45:50.71345 +02:00' as fr_time,
  PUBLIC.SWITCHOFFSET_UDF('1998-09-20 7:45:50.71345 +02:00', '-06:00') as cr_time;

結果:


fr_time	cr_time
1998-09-20 7:45:50.71345 +02:00	1998-09-19 23:45:50.7134500 -06:00

SYSDATETIME¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

SQL Serverのインスタンスが実行されているコンピューターの日付と時刻を含むdatetime2(7)値を返します。(Transact-SQL の SYSDATETIME)。

サンプルソースパターン¶

構文¶

SQL Server¶

SYSDATETIME ( )  

Snowflake SQL¶

LOCALTIME()

例¶

SQL Server¶

SELECT SYSDATETIME ( ) AS SYSTEM_DATETIME;

結果:


SYSTEM_DATETIME
2022-05-06 12:08:05.501

Snowflake SQL¶

SELECT LOCALTIME ( ) AS SYSTEM_DATETIME;

結果:


SYSTEM_DATETIME
211:09:14

SYSUTCDATETIME¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

SQL Serverのインスタンスが実行されているコンピューターの日付と時刻を含むdatetime2(7)値を返します。(Transact-SQL の SYSUTCDATETIME)。

サンプルソースパターン¶

構文¶

SQL Server¶

SYSUTCDATETIME ( )  

Snowflake SQL¶

SYSDATE()

例¶

SQL Server¶

SELECT SYSUTCDATETIME() as SYS_UTC_DATETIME;

結果:


SYSTEM_UTC_DATETIME
2023-02-02 20:59:28.0926502

Snowflake SQL¶

SELECT
SYSDATE() as SYS_UTC_DATETIME;

結果:


SYSTEM_UTC_DATETIME
2023-02-02 21:02:05.557

YEAR¶

Applies to

SQL Server
Azure Synapse Analytics

説明¶

指定された日付の年を表す整数を返します。(Transact-SQL の YEAR)。

サンプルソースパターン¶

構文¶

SQL Server¶

YEAR( date )  

Snowflake SQL¶