クイックスタート: サーバーレス SQL プールを使用する

[アーティクル]
2025/02/26

Synapse サーバーレス SQL プールは、Azure Storage に配置されたファイルに対して SQL クエリを実行できるようにするサーバーレスクエリサービスです。このクイックスタートでは、サーバーレス SQL プールを使用してさまざまな種類のファイルにクエリを実行する方法について説明します。サポートされる形式の一覧については、「OPENROWSET」を参照してください。

このクイックスタートでは、CSV、Apache Parquet、JSON ファイルに対してクエリを実行する方法について説明します。

前提条件

クエリを発行する SQL クライアントを選択します。

Azure Synapse Studio は、ストレージ内のファイルを参照したり、SQL クエリを作成したりするために使用できる Web ツールです。
Visual Studio Code の mssql 拡張機能は、オンデマンドデータベースで SQL クエリとノートブックを実行できるクロスプラットフォームの軽量開発者およびデータツールです。
SQL Server Management Studio は、オンデマンドデータベースで SQL クエリを実行できるクライアントツールです。

このクイックスタートでは、次のパラメーターを使用します。

パラメーター	説明
サーバーレス SQL プールサービスエンドポイントアドレス	サーバー名として使用されます
サーバーレス SQL プールサービスエンドポイントリージョン	サンプルで使用するストレージを決定するために使用されます
エンドポイントアクセスのユーザー名とパスワード	エンドポイントへのアクセスに使用されます
ビューの作成に使用するデータベース	サンプルの開始点として使用されるデータベース

初回セットアップ

サンプルを使用する前に、次の作業を行います。

ビューのデータベースを作成する (ビューを使用する場合)。
サーバーレス SQL プールがストレージ内のファイルにアクセスするために使用する資格情報を作成する。

データベースの作成

独自のデモ用データベースを作成します。このデータベースは、ビューの作成に使用するほか、この記事のサンプルクエリでも使用できます。

注意

このデータベースは、実際のデータではなくビューのメタデータに対してのみ使用されます。クイックスタートで後で使用するためにデータベース名を書き留めておきます。

次の T-SQL コマンドを使用します。<mydbname> は任意の名前に変更します。

SQL

CREATE DATABASE <mydbname>

データソースの作成

サーバーレス SQL プールを使用してクエリを実行するには、ストレージ内のファイルにアクセスするためにサーバーレス SQL プールが使用できるデータソースを作成します。次のコードスニペットを実行し、このセクションのサンプルで使用するデータソースを作成します。任意の強力なパスワードで <strong-password-here> を置き換えます。

SQL

-- create master key that will protect the credentials:
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<strong-password-here>'

-- create credentials for containers in our demo storage account
CREATE DATABASE SCOPED CREDENTIAL sqlondemand
WITH IDENTITY='SHARED ACCESS SIGNATURE',  
SECRET = 'sv=2022-11-02&ss=b&srt=co&sp=rl&se=2042-11-26T17:40:55Z&st=2024-11-24T09:40:55Z&spr=https&sig=DKZDuSeZhuCWP9IytWLQwu9shcI5pTJ%2Fw5Crw6fD%2BC8%3D'
GO
CREATE EXTERNAL DATA SOURCE SqlOnDemandDemo WITH (
    LOCATION = 'https://sqlondemandstorage.blob.core.windows.net',
    CREDENTIAL = sqlondemand
);

CSV ファイルに対してクエリを実行する

次の画像は、クエリを実行するファイルのプレビューを示しています。

ヘッダーがなく、Windows スタイルの改行を含む CSV ファイルの最初の 10 行を示すスクリーンショット。

次のクエリは、ヘッダー行を含まず、Windows スタイルの改行があり、コンマ区切りの列が存在する CSV ファイルを読み取る方法を示しています。

SQL

SELECT TOP 10 *
FROM OPENROWSET
  (
      BULK 'csv/population/*.csv',
      DATA_SOURCE = 'SqlOnDemandDemo',
      FORMAT = 'CSV', PARSER_VERSION = '2.0'
  )
WITH
  (
      country_code VARCHAR (5)
    , country_name VARCHAR (100)
    , year smallint
    , population bigint
  ) AS r
WHERE
  country_name = 'Luxembourg' AND year = 2017

クエリのコンパイル時にスキーマを指定できます。その他の例については、CSV ファイルに対してクエリを実行する方法を参照してください。

Parquet ファイルのクエリ

次のサンプルは、Parquet ファイルのクエリを実行するための自動スキーマ推論機能を示しています。これはスキーマを指定せずに 2017 年 9 月の行の数を返します。

注意

Parquet ファイルを読み取るときに OPENROWSET WITH 句で列を指定する必要はありません。この場合、サーバーレス SQL プールは Parquet ファイル内のメタデータを利用し、名前で列をバインドします。

SQL

SELECT COUNT_BIG(*)
FROM OPENROWSET
  (
      BULK 'parquet/taxi/year=2017/month=9/*.parquet',
      DATA_SOURCE = 'SqlOnDemandDemo',
      FORMAT='PARQUET'
  ) AS nyc

詳細については、「サーバーレス SQL プールを使用して Parquet ファイルに対してクエリを実行する」を参照してください。

JSON ファイルのクエリ

JSON サンプルファイル

ファイルは json コンテナーに books フォルダーを使用して格納され、次の構造を持つ 1 つの book エントリを含みます。

JSON

{  
   "_id":"ahokw88",
   "type":"Book",
   "title":"The AWK Programming Language",
   "year":"1988",
   "publisher":"Addison-Wesley",
   "authors":[  
      "Alfred V. Aho",
      "Brian W. Kernighan",
      "Peter J. Weinberger"
   ],
   "source":"DBLP"
}

サンプルクエリ

次のクエリは、JSON_VALUE を使用して、「Probabilistic and Statistical Methods in Cryptology, An Introduction」という書籍からスカラー値 (タイトル、出版社) を取得する方法を示しています。

SQL

SELECT
    JSON_VALUE(jsonContent, '$.title') AS title
  , JSON_VALUE(jsonContent, '$.publisher') as publisher
  , jsonContent
FROM OPENROWSET
  (
      BULK 'json/books/*.json',
      DATA_SOURCE = 'SqlOnDemandDemo'
    , FORMAT='CSV'
    , FIELDTERMINATOR ='0x0b'
    , FIELDQUOTE = '0x0b'
    , ROWTERMINATOR = '0x0b'
  )
WITH
  ( jsonContent varchar(8000) ) AS [r]
WHERE
  JSON_VALUE(jsonContent, '$.title') = 'Probabilistic and Statistical Methods in Cryptology, An Introduction'

重要

JSON ファイル全体を 1 つの行または列として読み取ります。そのため、FIELDTERMINATOR、FIELDQUOTE、および ROWTERMINATOR は、ファイル内で見つからないため、0x0b に設定されます。

次の方法で共有

クイックスタート: サーバーレス SQL プールを使用する

前提条件

初回セットアップ

データベースの作成

データソースの作成

CSV ファイルに対してクエリを実行する

Parquet ファイルのクエリ

JSON ファイルのクエリ

JSON サンプルファイル

サンプルクエリ

フィードバック

その他のリソース

次の方法で共有

クイックスタート: サーバーレス SQL プールを使用する

前提条件

初回セットアップ

データベースの作成

データ ソースの作成

CSV ファイルに対してクエリを実行する

Parquet ファイルのクエリ

JSON ファイルのクエリ

JSON サンプル ファイル

サンプル クエリ

関連するコンテンツ

フィードバック

その他のリソース

データソースの作成

JSON サンプルファイル

サンプルクエリ