CREATE EXTERNAL TABLE AS SELECT (CETAS) (Transact-SQL)

適用対象: SQL Server 2022 (16.x) 以降 Azure Synapse AnalyticsAnalytics Platform System (PDW)

外部テーブルを作成し、次に Transact-SQL SELECT ステートメントの結果を並行してエクスポートします。

• Azure Synapse Analytics と Analytics Platform System では、Hadoop または Azure Blob Storage がサポートされています。
• SQL Server 2022 (16.x) 以降のバージョンでは、外部テーブルを作成し、Transact-SQL SELECT ステートメントの結果を Azure Data Lake Storage (ADLS) Gen2、Azure Storage Account V2、S3 互換オブジェクト ストレージに並行してエクスポートする CREATE EXTERNAL TABLE AS SELECT (CETAS) がサポートされています。

注意

Azure SQL Managed Instance 用の CETAS の機能とセキュリティは、SQL Server または Azure Synapse Analytics とは異なります。 詳細については、CREATE EXTERNAL TABLE AS SELECT の Azure SQL Managed Instance バージョンを参照してください。

注意

Azure Synapse Analytics のサーバーレス プール用の CETAS の機能とセキュリティは、SQL Server とは異なります。 詳細については、「Synapse SQL での CETAS」を参照してください。

Transact-SQL 構文表記規則

構文

CREATE EXTERNAL TABLE { [ [ database_name . [ schema_name ] . ] | schema_name . ] table_name }
    [ (column_name [ , ...n ] ) ]
    WITH (
        LOCATION = 'hdfs_folder' | '<prefix>://<path>[:<port>]' ,
        DATA_SOURCE = external_data_source_name ,
        FILE_FORMAT = external_file_format_name
        [ , <reject_options> [ , ...n ] ]
    )
    AS <select_statement>
[;]

<reject_options> ::=
{
    | REJECT_TYPE = value | percentage
    | REJECT_VALUE = reject_value
    | REJECT_SAMPLE_VALUE = reject_sample_value
}

<select_statement> ::=
    [ WITH <common_table_expression> [ , ...n ] ]
    SELECT <select_criteria>

引数

[ [ database_name . [ schema_name ] . ] | schema_name . ] table_name

データベースで作成するテーブルの 1 つから 3 つの部分で構成される名前。 外部テーブルの場合、リレーショナル データベースにはテーブル メタデータのみが格納されます。

[ ( column_name [ ,...n ] ) ]

テーブルの列の名前です。

LOCATION

適用対象: Azure Synapse Analytics および Analytics Platform System

'hdfs_folder'**
外部データ ソースで SELECT ステートメントの結果を書き込む場所を指定します。 場所はフォルダー名であり、必要に応じて、Hadoop クラスターまたは BLOB ストレージのルート フォルダーへの相対パスを含めることができます。 PolyBase ではパスとフォルダー (まだ存在しない場合) が作成されます。

外部ファイルは hdfs_folder に書き込まれ、QueryID_date_time_ID.format という名前が付けられます (ID は増分識別子、format はエクスポートされるデータ形式)。 たとえば QID776_20160130_182739_0.orc です。

LOCATION は、フォルダーを指す必要があり、末尾に / を付ける必要があります (例: aggregated_data/)。

適用対象: SQL Server 2022 (16.x) 以降

prefix://path[:port] には、SELECT ステートメントの結果が書き込まれる外部データ ソースに対する接続プロトコル (プレフィックス)、パス、ポート (省略可能) を指定します。

宛先が S3 互換のオブジェクト ストレージである場合、まずバケットが存在する必要がありますが、必要に応じて PolyBase でサブフォルダーを作成することができます。 SQL Server 2022 (16.x) は、Azure Data Lake Storage Gen2、Azure Storage Account V2、S3 互換のオブジェクト ストレージをサポートします。 現在、ORC ファイルはサポートされていません。

DATA_SOURCE = external_data_source_name

外部データが格納されている、または格納される場所を含む、外部データ ソース オブジェクトの名前を指定します。 場所は、Hadoop クラスターまたは Azure Blob ストレージのいずれかです。 外部データ ソースを作成するには、CREATE EXTERNAL DATA SOURCE (Transact-SQL) を使用します。

FILE_FORMAT = external_file_format_name

外部データ ファイルの形式を含む、外部ファイル形式オブジェクトの名前を指定します。 外部ファイル形式を作成するには、CREATE EXTERNAL FILE FORMAT (Transact-SQL) を使用します。

REJECT オプション

この CREATE EXTERNAL TABLE AS SELECT ステートメントの実行時に、REJECT オプションは適用されません。 代わりに、ここで指定し、後で外部テーブルからデータをインポートする際に、データベースで使用できるようにします。 後で CREATE TABLE AS SELECT ステートメントで外部テーブルからデータを選択するときに、データベースでは拒否オプションを使用して、インポートを停止するまでにインポートの失敗が許容される行の数または割合を決定します。

• REJECT_VALUE = reject_value

  データベースがインポートを停止するまでに、インポートの失敗が許容される行数の値または割合を指定します。

• REJECT_TYPE = value | percentage

  REJECT_VALUE オプションがリテラル値か割合かを明確にします。

  • value

    REJECT_VALUE が割合ではなくリテラル値の場合に使われます。 失敗した行の数が reject_value を超えた場合、データベースは外部データ ファイルからの行のインポートを停止します。

    たとえば、REJECT_VALUE = 5、REJECT_TYPE = value の場合、データベースは 5 つの行のインポートに失敗した後、行のインポートを停止します。

  • percentage

    REJECT_VALUE がリテラル値ではなく割合の場合に使われます。 失敗した行の percentage が reject_value を超えた場合、データベースは外部データ ファイルからの行のインポートを停止します。 失敗した行の割合は、間隔をおいて計算されます。 TYPE=HADOOP の場合は、専用 SQL プールでのみ有効です。

• REJECT_SAMPLE_VALUE = reject_sample_value

  REJECT_TYPE = percentage の場合に必要です。 データベースが失敗した行の割合を再計算する前に、インポートを試みる行の数を指定します。

  たとえば、REJECT_SAMPLE_VALUE = 1000 の場合、データベースは外部データ ファイルから 1000 行のインポートを試みた後、失敗した行の割合を計算します。 失敗した行の割合が reject_value 未満の場合、データベースは別の 1000 行の読み込みを試みます。 データベースは引き続き、その 1000 行のそれぞれのインポートを試みた後、失敗した行の割合を再計算します。

  Note

  データベースは一定の間隔で失敗した行の割合を計算するため、失敗した行の実際の割合が reject_value を超える場合があります。

  例:

  この例は、REJECT の 3 つのオプションが相互にどのように作用するかを示しています。 たとえば、REJECT_TYPE = percentage, REJECT_VALUE = 30, REJECT_SAMPLE_VALUE = 100 の場合、次のシナリオが発生する可能性があります。

  • データベースでは、最初の 100 行の読み込みが試行されます。この場合、失敗が 25、成功が 75 です。
  • 失敗した行の割合は 25% と計算されます。これは reject 値である 30% を下回っています。 そのため、読み込みを停止する必要はありません。
  • データベースでは、次の 100 行の読み込みが試行されます。 今回は成功が 25、失敗が 75 です。
  • 失敗した行の割合が 50% として再計算されます。 失敗した行の割合が、30% という reject 値を超えました。
  • 200 行の読み込みを試みた後、失敗した行の割合が 50% で読み込みに失敗しています。この割合は、指定された制限の 30% を超えています。

WITH common_table_expression

共通テーブル式 (CTE) と呼ばれる一時的な名前付き結果セットを指定します。 詳細については、「WITH common_table_expression (Transact-SQL)」を参照してください

SELECT <select_criteria>

SELECT ステートメントの結果を新しいテーブルに追加します。 select_criteria は、新しいテーブルにコピーするデータを決定する SELECT ステートメントの本文です。 SELECT ステートメントについては、「SELECT (Transact-SQL)」を参照してください。

Note

SELECT の ORDER BY 句は CETAS には影響しません。

列のオプション

• column_name [ ,...n ]

  列名では、CREATE TABLE に示されている列のオプションは使用できません。 代わりに、新しいテーブルには 1 つ以上の列名のオプション リストを指定できます。 新しいテーブルの列では、指定した名前が使用されます。 列名を指定する場合、列リスト内の列の数は、SELECT の結果内の列の数と一致する必要があります。 列名を指定しない場合、新しいターゲット テーブルでは、SELECT ステートメントの結果の列名が使用されます。

  データ型、照合順序、NULL 値の許容など、他の列オプションを指定することはできません。 これらの各属性は、SELECT ステートメントの結果から派生されます。 ただし、SELECT ステートメントを使用して、属性を変更することができます。 例については、CETAS を使用した列属性の変更に関するページを参照してください。

アクセス許可

このコマンドを実行するには、データベース ユーザーは以下のすべての権限またはメンバーシップが必要です。

• db_ddladmin 固定データベース ロールの新しいテーブルまたはメンバーシップを含む、ローカル スキーマに対する ALTER SCHEMA 権限。
• db_ddladmin 固定データベース ロールの CREATE TABLE 権限またはメンバーシップ。
• select_criteria で参照されるすべてのオブジェクトに対する SELECT 権限。

ログインには次のすべての権限が必要です。

• ADMINISTER BULK OPERATIONS
• ALTER ANY EXTERNAL DATA SOURCE
• ALTER ANY EXTERNAL FILE FORMAT
• 一般に、CETAS のためには、フォルダーの内容を一覧表示し、LOCATION フォルダーに書き込むためのアクセス許可が必要です。
• Azure Synapse Analytics と Analytics Platform System の場合、Hadoop クラスターまたは Azure BLOB ストレージ上の外部フォルダーに対して読み取りと書き込みを行う書き込みアクセス許可。
• SQL Server 2022 (16.x) では、外部の場所に対して適切なアクセス許可を設定する必要もあります。 その場所にデータを出力する書き込みアクセス許可と、それにアクセスする読み取りアクセス許可です。
• Azure Blob Storage と Azure Data Lake Gen2 の場合、コンテナー上で SHARED ACCESS SIGNATURE トークンに閲覧、書き込み、一覧表示、作成の特権を付与する必要があります。
• Azure Blog Storage の場合、SAS トークンを生成するには、Allowed Services: Blob チェックボックスをオンにする必要があります。
• Azure Data Lake Gen2 の場合、SAS トークンを生成するには、Allowed Services: Container および Object チェックボックスをオンにする必要があります。

重要

ALTER ANY EXTERNAL DATA SOURCE 権限は、あらゆる外部データ ソース オブジェクトを作成し、変更する能力をプリンシパルに与えます。そのため、データベース上のすべてのデータベース スコープ資格情報にアクセスする能力も与えます。 この権限は特権として考える必要があり、システム内の信頼できるプリンシパルにのみ与える必要があります。

エラー処理

CREATE EXTERNAL TABLE AS SELECT でデータをテキスト区切りファイルにエクスポートした場合、エクスポートに失敗した行に対する拒否ファイルはありません。

外部テーブルの作成時に、データベースによって、外部の場所への接続が試行されます。 接続に失敗した場合、コマンドは失敗し、外部テーブルは作成されません。 データベースは接続を 3 回以上再試行するため、コマンドが失敗するまで 1 分以上かかる場合があります。

CREATE EXTERNAL TABLE AS SELECT が取り消されたか、失敗した場合、データベースにより、外部データ ソースで既に作成されている新しいファイルとフォルダーの削除が 1 回だけ試みられます。

Azure Synapse Analytics と Analytics Platform System では、データのエクスポート時に外部データ ソースで発生した Java エラーがデータベースから報告されます。

注釈

CREATE EXTERNAL TABLE AS SELECT ステートメントが完了したら、外部テーブルに対して Transact-SQL クエリを実行できます。 CREATE TABLE AS SELECT ステートメントを使用してインポートする場合を除き、これらの操作ではクエリの実行中にデータをデータベースにインポートします。

外部テーブルの名前と定義は、データベースのメタデータに格納されます。 データは外部データ ソースに格納されます。

CREATE EXTERNAL TABLE AS SELECT ステートメントを使用すると、ソース テーブルがパーティション分割されている場合でも、常にパーティション分割されていないテーブルが作成されます。

SQL Server 2022 (16.x) の場合、sp_configure を使用してオプション allow polybase export を有効にする必要があります。 詳細については、「allow polybase export 構成オプションの設定」を参照してください。

Azure Synapse Analytics と Analytics Platform System のクエリ プランを EXPLAIN を使って作成した場合、データベースは、外部シャッフル移動、外部ブロードキャスト移動、外部パーティション移動というクエリ プラン操作を外部テーブルに対して使います。

Analytics Platform System では、外部テーブルを作成するための前提条件として、アプライアンス管理者は Hadoop 接続を構成する必要があります。 詳細については、Analytics Platform System のドキュメントの外部データへの接続の構成 (Analytics Platform System) に関する記事を参照してください。このドキュメントは、Microsoft ダウンロード センターからダウンロードできます。

制限事項と制約事項

外部テーブル データがデータベースの外部にあるため、バックアップおよび復元操作はデータベースに格納されているデータに対してのみ動作します。 その結果、メタデータのみがバックアップおよび復元されます。

データベースでは、外部テーブルを含むデータベース バックアップを復元する際に、外部データ ソースへの接続は確認されません。 元のソースにアクセスできない場合でも、外部テーブルのメタデータの復元は成功します。ただし、外部テーブルに対する SELECT 操作は失敗します。

データベースでは、データベースと外部データ間のデータの一貫性は保証されません。 外部データとデータベース間の一貫性を保つことだけは、お客様が行う必要があります。

外部テーブルでのデータ操作言語 (DML) 操作はサポートされていません。 たとえば、Transact-SQL の UPDATE、INSERT、DELETE Transact-SQL ステートメントを使用して、外部データを変更することはできません。

外部テーブルで許可されるデータ定義言語 (DDL) 操作は、CREATE TABLE、DROP TABLE、CREATE STATISTICS、DROP STATISTICS、CREATE VIEW、DROP VIEW のみです。

Azure Synapse Analytics の制限事項と制約事項

• Azure Synapse Analytics 専用 SQL プールと Analytics Platform System では、PolyBase クエリを同時に 32 個に実行した場合、PolyBase によってフォルダーごとに最大 33,000 個のファイルを消費できます。 この最大数には、各 HDFS フォルダー内のファイルとサブフォルダーの両方が含まれます。 コンカレンシーの度合いが 32 未満である場合、ユーザーは 33,000 より多いファイルが含まれている HDFS のフォルダーに対して PolyBase クエリを実行できます。 Hadoop および PolyBase のユーザーがファイル パスを短くし、HDFS フォルダーごとに 30,000 以下のファイルを使用することをお勧めします。 参照されているファイルが多すぎると、JVM のメモリ不足例外が発生します。

• サーバーレス SQL プールでは、外部テーブルを現在データがある場所に作成することはできません。 データの格納に使用されている場所を再利用するには、その場所を ADLS で手動で削除する必要があります。 その他の制限事項とベスト プラクティスについては、フィルター最適化のベスト プラクティスに関する記事を参照してください。

Azure Synapse Analytics 専用 SQL プールと Analytics Platform System では、CREATE EXTERNAL TABLE AS SELECT を使って RCFile から選ぶ場合、RCFile の列値にパイプ (|) 文字を含めることはできません。

CREATE EXTERNAL TABLE AS SELECT では SET ROWCOUNT (Transact-SQL) の効果はありません。 同様の動作を実現するには、TOP (Transact-SQL) を使用します。

ファイル名の制限については、「コンテナー、BLOB、メタデータの名前付けと参照」を参照してください。

文字エラー

データ内に次の文字が存在する場合、Parquet ファイルに対して CREATE EXTERNAL TABLE AS SELECT を実行すると、レコードの拒否などのエラーが発生することがあります。

Azure Synapse Analytics と Analytics Platform System では、これは ORC ファイルにも適用されます。

• |
• " (引用符文字)
• \r\n
• \r
• \n

これらの文字が含まれる CREATE EXTERNAL TABLE AS SELECT を使用するには、最初にデータに CREATE EXTERNAL TABLE AS SELECT ステートメントを実行してデータを区切りテキストファイルにエクスポートする必要があり、その後は外部ツールを使用して Parquet または ORC に変換することができます。

Parquet の操作

Parquet ファイルを使用する場合、 CREATE EXTERNAL TABLE AS SELECT は構成された最大並列度 (MAXDOP) まで、使用可能な CPU ごとに 1 つの Parquet ファイルが生成されます。 各ファイルは最大 190 GB まで拡張できます。その後、SQL Server は必要に応じてより多数の Parquet ファイルを生成します。

クエリ ヒント OPTION (MAXDOP n) は、CREATE EXTERNAL TABLE AS SELECT の SELECT 部分にのみ影響し、Parquet ファイルの量には影響しません。 データベース レベルの MAXDOP とインスタンス レベルの MAXDOP のみが考慮されます。

ロック

SCHEMARESOLUTION オブジェクトの共有ロックを取得します。

サポートされるデータ型

CETAS を使用して、次の SQL データ型の結果セットを格納できます。

• [バイナリ]
• varbinary
• char
• varchar
• nchar
• nvarchar
• smalldate
• date
• DATETIME
• datetime2
• datetimeoffset
• time
• decimal
• numeric
• float
• real
• bigint
• tinyint
• smallint
• INT
• bigint
• bit
• money
• smallmoney

例

A. CREATE EXTERNAL TABLE AS SELECT を使用して Hadoop テーブルを作成する

適用対象: Azure Synapse Analytics および Analytics Platform System

次の例では、ソース テーブル dimCustomer の列の定義とデータを使用して、hdfsCustomer という名前の新しい外部テーブルを作成します。

テーブル定義はデータベースに格納され、SELECT ステートメントの結果は、Hadoop 外部データソース customer_ds の /pdwdata/customer.tbl ファイルにエクスポートされます。 ファイルは、外部ファイル形式 customer_ff に従って書式設定されます。

ファイル名はデータベースによって生成され、クエリ ID を含みます。これにより、ファイルを生成元のクエリに合わせやすくなります。

Customer ディレクトリの前のパス hdfs://xxx.xxx.xxx.xxx:5000/files/ は既に存在している必要があります。 Customer ディレクトリが存在しない場合は、データベースでそのディレクトリが作成されます。

Note

この例では 5000 に指定されています。 ポートが指定されていない場合、データベースは既定のポートとして 8020 を使用します。

結果の Hadoop の場所とファイル名は hdfs:// xxx.xxx.xxx.xxx:5000/files/Customer/ QueryID_YearMonthDay_HourMinutesSeconds_FileIndex.txt. です。

-- Example is based on AdventureWorks
CREATE EXTERNAL TABLE hdfsCustomer
    WITH (
            LOCATION = '/pdwdata/customer.tbl',
            DATA_SOURCE = customer_ds,
            FILE_FORMAT = customer_ff
            ) AS

SELECT *
FROM dimCustomer;
GO

B. CREATE EXTERNAL TABLE AS SELECT でクエリ ヒントを使用する

適用対象: Azure Synapse Analytics および Analytics Platform System

このクエリは、CREATE EXTERNAL TABLE AS SELECT ステートメントでクエリ結合ヒントを使用する場合の基本的な構文を示しています。 クエリが送信された後、データベースではハッシュ結合方法を使用して、クエリ プランを生成します。 結合ヒントと OPTION 句の使用方法の詳細については、「OPTION 句 (Transact-SQL)」を参照してください。

Note

この例では 5000 に指定されています。 ポートが指定されていない場合、データベースは既定のポートとして 8020 を使用します。

-- Example is based on AdventureWorks
CREATE EXTERNAL TABLE dbo.FactInternetSalesNew
    WITH (
            LOCATION = '/files/Customer',
            DATA_SOURCE = customer_ds,
            FILE_FORMAT = customer_ff
            ) AS

SELECT T1.*
FROM dbo.FactInternetSales T1
INNER JOIN dbo.DimCustomer T2
    ON (T1.CustomerKey = T2.CustomerKey)
OPTION (HASH JOIN);
GO

C. CETAS を使用して列属性を変更する

適用対象: Azure Synapse Analytics および Analytics Platform System

この例では CETAS を使用して、FactInternetSales テーブルのデータ型、NULL 値の許容、いくつかの列の照合順序を変更します。

-- Example is based on AdventureWorks
CREATE EXTERNAL TABLE dbo.FactInternetSalesNew
    WITH (
            LOCATION = '/files/Customer',
            DATA_SOURCE = customer_ds,
            FILE_FORMAT = customer_ff
            ) AS

SELECT T1.ProductKey AS ProductKeyNoChange,
    T1.OrderDateKey AS OrderDate,
    T1.ShipDateKey AS ShipDate,
    T1.CustomerKey AS CustomerKeyNoChange,
    T1.OrderQuantity AS Quantity,
    T1.SalesAmount AS MONEY
FROM dbo.FactInternetSales T1
INNER JOIN dbo.DimCustomer T2
    ON (T1.CustomerKey = T2.CustomerKey)
OPTION (HASH JOIN);
GO

D. データを parquet としてエクスポートして CREATE EXTERNAL TABLE AS SELECT を使う

適用対象: SQL Server 2022 (16.x)

次の例では、AdventureWorks2022 のテーブル SalesOrderDetail のデータを使う ext_sales という新しい外部テーブルを作成します。 allow polybase export 構成オプションを有効にする必要があります。

SELECT ステートメントの結果は、あらかじめ構成した S3 互換のオブジェクト ストレージに保存され、s3_eds という名前が付けられ、s3_dsc という適切な資格情報が作成されます。 parquet ファイルの場所は <ip>:<port>/cetas/sales.parquet になります。この cetas は以前に作成したストレージ バケットです。

注意

現在、Delta の形式は読み取り専用としてのみサポートされています。

-- Credential to access the S3-compatible object storage
CREATE DATABASE SCOPED CREDENTIAL s3_dsc
    WITH IDENTITY = 'S3 Access Key',
        SECRET = '<accesskeyid>:<secretkeyid>'
GO

-- S3-compatible object storage data source
CREATE EXTERNAL DATA SOURCE s3_eds
    WITH (
            LOCATION = 's3://<ip>:<port>',
            CREDENTIAL = s3_dsc
            )

-- External File Format for PARQUET
CREATE EXTERNAL FILE FORMAT ParquetFileFormat
    WITH (FORMAT_TYPE = PARQUET);
GO

CREATE EXTERNAL TABLE ext_sales
    WITH (
            LOCATION = '/cetas/sales.parquet',
            DATA_SOURCE = s3_eds,
            FILE_FORMAT = ParquetFileFormat
            ) AS

SELECT *
FROM AdventureWorks2022.[Sales].[SalesOrderDetail];
GO

E. delta テーブルから parquet に対して CREATE EXTERNAL TABLE AS SELECT を使う

適用対象: SQL Server 2022 (16.x)

次の例では、s3_delta という S3 互換のオブジェクト ストレージにある Delta テーブル型のデータを使う、Delta_to_Parquet という新しい外部テーブルを作成し、その結果を s3_parquet という別のデータ ソースに parquet ファイルとして書き込みます。 そのために、この例では OPENROWSET コマンドを利用しています。 allow polybase export 構成オプションを有効にする必要があります。

-- External File Format for PARQUET
CREATE EXTERNAL FILE FORMAT ParquetFileFormat
    WITH (FORMAT_TYPE = PARQUET);
GO

CREATE EXTERNAL TABLE Delta_to_Parquet
    WITH (
            LOCATION = '/backup/sales.parquet',
            DATA_SOURCE = s3_parquet,
            FILE_FORMAT = ParquetFileFormat
            ) AS

SELECT *
FROM OPENROWSET(BULK '/delta/sales_fy22/', FORMAT = 'DELTA', DATA_SOURCE = 's3_delta') AS [r];
GO

F. ビューをソースとして使用する CREATE EXTERNAL TABLE AS SELECT を使う

適用対象: Azure Synapse Analytics サーバーレス SQL プールと専用 SQL プール。

この例では、ユーザー定義ビューをソースとして CETAS を記述し、マネージド ID を認証として使用するテンプレート コードの例を確認できます wasbs:。

CREATE DATABASE [<mydatabase>];
GO

USE [<mydatabase>];
GO

CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<strong password>';

CREATE DATABASE SCOPED CREDENTIAL [WorkspaceIdentity] WITH IDENTITY = 'managed identity';
GO

CREATE EXTERNAL FILE FORMAT [ParquetFF] WITH (
    FORMAT_TYPE = PARQUET,
    DATA_COMPRESSION = 'org.apache.hadoop.io.compress.SnappyCodec'
);
GO

CREATE EXTERNAL DATA SOURCE [SynapseSQLwriteable] WITH (
    LOCATION = 'wasbs://<mystoageaccount>.dfs.core.windows.net/<mycontainer>/<mybaseoutputfolderpath>',
    CREDENTIAL = [WorkspaceIdentity]
);
GO

CREATE EXTERNAL TABLE [dbo].[<myexternaltable>] WITH (
        LOCATION = '<myoutputsubfolder>/',
        DATA_SOURCE = [SynapseSQLwriteable],
        FILE_FORMAT = [ParquetFF]
) AS
SELECT * FROM [<myview>];
GO

G. ビューをソースとして使用する CREATE EXTERNAL TABLE AS SELECT を使う

適用対象: Azure Synapse Analytics サーバーレス SQL プールと専用 SQL プール。

この例では、ユーザー定義ビューをソースとして CETAS を記述し、マネージド ID を認証として使用するテンプレート コードの例を確認できます https:。

CREATE DATABASE [<mydatabase>];
GO

USE [<mydatabase>];
GO

CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<strong password>';

CREATE DATABASE SCOPED CREDENTIAL [WorkspaceIdentity] WITH IDENTITY = 'managed identity';
GO

CREATE EXTERNAL FILE FORMAT [ParquetFF] WITH (
    FORMAT_TYPE = PARQUET,
    DATA_COMPRESSION = 'org.apache.hadoop.io.compress.SnappyCodec'
);
GO

CREATE EXTERNAL DATA SOURCE [SynapseSQLwriteable] WITH (
    LOCATION = 'https://<mystoageaccount>.dfs.core.windows.net/<mycontainer>/<mybaseoutputfolderpath>',
    CREDENTIAL = [WorkspaceIdentity]
);
GO

CREATE EXTERNAL TABLE [dbo].[<myexternaltable>] WITH (
        LOCATION = '<myoutputsubfolder>/',
        DATA_SOURCE = [SynapseSQLwriteable],
        FILE_FORMAT = [ParquetFF]
) AS
SELECT * FROM [<myview>];
GO

次の手順

• CREATE EXTERNAL DATA SOURCE (Transact-SQL)
• CREATE EXTERNAL FILE FORMAT (Transact-SQL)
• CREATE EXTERNAL TABLE (Transact-SQL)
• CREATE TABLE (Azure Synapse Analytics、Parallel Data Warehouse)
• CREATE TABLE AS SELECT (Azure Synapse Analytics)
• DROP TABLE (Transact-SQL)
• ALTER TABLE (Transact-SQL)