Azure Synapse Link for SQL Server 2022 の概要

[アーティクル]
06/01/2023

この記事は、Azure Synapse Link for SQL Server 2022 の使用を開始するための詳細なガイドです。概要については、「Azure Synapse Link for SQL Server 2022」を参照してください。

前提条件

開始する前に、「新しいAzure Synapse ワークスペースを作成する」を参照して、Azure Synapse Link for SQL を取得します。このチュートリアルでは、パブリックネットワークに Azure Synapse Link for SQL を作成します。この記事では、Azure Synapse ワークスペースの作成時に [マネージド仮想ネットワークを無効にする] と [すべての IP アドレスからの接続を許可する] を選択していることを前提としています。ネットワークセキュリティを使用して Azure Synapse Link for SQL Server 2022 を構成する場合は、「ネットワークセキュリティを使用して Azure Synapse Link for SQL Server 2022 を構成する」も参照してください。
Azure Data Lake Storage Gen2 アカウントを作成します。これは、Azure Synapse Analytics ワークスペースで作成するアカウントとは異なります。このアカウントをランディングゾーンとして使用して、SQL Server 2022 によって送信されたデータをステージします。詳細については、Azure Data Lake Storage Gen2 アカウントの作成に関するページを参照してください。
SQL Server 2022 データベースにマスターキーが作成されていることを確認します。
```
CREATE MASTER KEY ENCRYPTION BY PASSWORD = '<a new password>'
```

ターゲット Azure Synapse SQL 専用プールを作成する

Synapse Studio を開きます。
[管理] ハブを開き、[SQL プール] に移動し、[新規] を選びます。
一意のプール名を入力し、既定の設定を使用して、専用プールを作成します。
[データ] ハブの [ワークスペース] で、[データベース] の下に新しい Azure Synapse SQL データベースが表示されます。新しい Azure Synapse SQL データベースで、[新しいSQL スクリプト]、[空のスクリプト] の順に選びます。
ターゲット Azure Synapse SQL データベースのマスターキーを作成するには、次のスクリプトを貼り付けて、[実行] を選びます。
```
CREATE MASTER KEY
```

ソース SQL Server 2022 データベースのリンクサービスを作成する

[管理ハブ] ボタン、[リンクサービス] の順に選びます。
[新規] を押し、[SQL Server] を選択し、[続行] を選択します。
[名前] ボックスに、SQL Server 2022 のリンクサービスの名前を入力します。
統合ランタイムを選ぶ場合は、セルフホステッド統合ランタイムを選びます。 Azure Synapse ワークスペースに使用可能なセルフホステッド統合ランタイムがない場合は、作成します。
(省略可能) ソース SQL Server 2022 に接続するセルフホステッド統合ランタイムを作成するには、次の手順を実行します。

a. [新規] を選択します。

b. [セルフホステッド]、[続行] の順に選びます。

c. [名前] ボックスにセルフホステッド統合ランタイムの名前を入力し、[作成] を選びます。

Azure Synapse ワークスペースでセルフホステッド統合ランタイムが使用できるようになりました。

d. 画面の指示に従って、キーのダウンロードとインストールを行い、そのキーを使用して、SQL Server 2022 インスタンスに直接アクセスできる Windows マシンに統合ランタイムエージェントを登録します。詳細については、セルフホステッド統合ランタイムの作成 - Azure Data Factory と Azure Synapse に関するページを参照してください。

e. [閉じる] を選択します。

f. 監視ページに移動し、[更新] を選択して統合ランタイムの最新の状態を取得して、セルフホステッド統合ランタイムが実行されていることを確認します。
続けて、[SQL Server 名]、[データベース名]、[認証の種類]、[ユーザー名]、[パスワード] など、SQL Server 2022 インスタンスに接続するためのリンクサービスの残りの情報を入力します。

注意

この接続で暗号化を有効にすることをお勧めします。これを行うには、値が true の Encrypt プロパティを追加の接続プロパティとして追加します。また、Trust Server Certificate プロパティを、サーバー構成に応じて true または false に設定します。詳細については、「データベースエンジンへの暗号化接続の有効化」を参照してください。
[テスト接続] を選択して、SQL Server インスタンス上でセルフホステッド統合ランタイムにアクセスできることを確認します。
［作成］ を選択します

新しいリンクサービスは、ワークスペースで使用できる SQL Server 2022 インスタンスに接続されます。

注意

ここで作成するリンクサービスは、Azure Synapse Link for SQL 専用ではありません。これは、適切なアクセス許可を持つ任意のワークスペースユーザーが使用できます。時間を確保して、このリンクサービスとその資格情報にアクセスできるユーザーの範囲を把握します。 Azure Synapse ワークスペースのアクセス許可の詳細については、Azure Synapse ワークスペースのアクセス制御の概要 (Azure Synapse Analytics) に関するページを参照してください。

Azure Data Lake Storage Gen2 のランディングゾーンに接続するリンクサービスを作成する

新しく作成した Azure Data Lake Storage Gen2 アカウントに移動し、[アクセス制御 (IAM)]、[追加]、[ロールの割り当ての追加] の順に選びます。
選択したロールに対して [ストレージ BLOB データ共同作成者] を選び、[マネージド ID] を選んでから [メンバー] でお使いの Azure Synapse ワークスペースを選びます。このロールの割り当ての追加には数分かかる場合があります。

注意

ランディングゾーンとして使用される Azure Data Lake Storage Gen2 ストレージアカウントに、Azure Synapse ワークスペースマネージド ID のアクセス許可が付与されていることを確認してください。詳細については、Azure Synapse ワークスペースでマネージド ID にアクセス許可を付与する - Azure Synapse Analytics に関するページを参照してください。
Azure Synapse ワークスペースで [管理] ハブを開き、[リンクサービス] に移動します。
[新規]、[Azure Data Lake Storage Gen2] の順に選びます。
次の操作を行います。

a. [名前] ボックスに、ランディングゾーンのリンクサービスの名前を入力します。

b. [認証方法] に、マネージド ID を入力します。

c. 既に作成されているストレージアカウント名を選びます。
[テスト接続] を選び、Azure Data Lake Storage Gen2 アカウントのアクセス権があることを確認します。
［作成］ を選択します

新しいリンク　サービスは、Azure Data Lake Storage Gen2 アカウントに接続されます。

注意

ここで作成するリンクサービスは、Azure Synapse Link for SQL 専用ではありません。これは、適切なアクセス許可を持つ任意のワークスペースユーザーが使用できます。時間を確保して、このリンクサービスとその資格情報にアクセスできるユーザーの範囲を把握します。 Azure Synapse ワークスペースのアクセス許可の詳細については、Azure Synapse ワークスペースのアクセス制御の概要 (Azure Synapse Analytics) に関するページを参照してください。

Azure Synapse Link 接続を作成する

Synapse Studio から、統合ハブを開きます。
[統合] ペインで、プラス記号 (+) を選び、[リンク接続] を選びます。
ソースデータベースを入力します。

a. [ソースの種類] には [SQL Server] を選びます。

b、ソース リンクサービスには、SQL Server 2022 インスタンスに接続するサービスを選びます。

c. [テーブル名] には、Azure Synapse SQL プールにレプリケートする SQL Server インスタンスの名前を選びます。

d. [続行] をクリックします。
[Synapse SQL 専用プール] からターゲットデータベース名を選びます。
[続行] を選択します。
リンク接続設定を入力します。

a. [リンク接続名] に名前を入力します。

b. リンク接続コンピューティングの [コア数] に、コアの数を入力します。これらのコアは、ソースからターゲットへのデータの移動に使用されます。少ない数から始めて、必要に応じてカウントを増やすことをお勧めします。

c. [リンクサービス] には、ランディングゾーンに接続するサービスを選びます。

d. Azure Data Lake Storage Gen2 のコンテナー名またはコンテナー/フォルダー名を、データをステージングするランディングゾーンフォルダーパスとして入力します。最初にコンテナーを作成する必要があります。

e. Azure Data Lake Storage Gen2 共有アクセス署名トークンを入力します。このトークンは、SQL 変更フィードがランディングゾーンにアクセスするために必要です。 Azure Data Lake Storage Gen2 アカウントに共有アクセス署名トークンがない場合は、[トークンの生成] を選択して作成できます。

f. [OK] を選択します。

Note

ここで選択したコアの数は、データの読み込みと変更を処理するためにインジェストサービスに割り当てられます。ターゲット専用の SQL プールの構成には影響しません。ストレージからの制限により、生成された SAS トークンを使用してランディングゾーンに接続できない場合は、委任 SAS トークンを使用してランディングゾーンに接続することもできます。
新しい Azure Synapse Link 接続を開いた状態で、ターゲットテーブル名、配布の種類、構造の種類を更新できるようになりました。
注意
- データに varchar(max)、nvarchar(max)、varbinary(max) が含まれている場合は、構造の種類に "ヒープテーブル" を使用することを検討してください。
- リンク接続を開始する前に、Azure Synapse SQL 専用プールにスキーマが既に作成されていることを確認します。 Azure Synapse Link for SQL では、Azure Synapse SQL プールのスキーマの下にテーブルが自動的に作成されます。
[すべて公開] を選択し、サービスに対する新しいリンク接続を保存します。

Azure Synapse Link 接続を開始する

[開始] を選択して数分待つと、データがレプリケートされます。

注意

リンク接続は、ソースデータベースの完全な初期読み込みから開始され、続いて SQL Server 2022 の変更フィード機能により増分変更フィードが行われます。詳細については、「Azure Synapse Link for SQL の変更フィード」を参照してください。

Azure Synapse Link for SQL Server 2022 を監視する

Azure Synapse Link 接続の状態を監視し、最初にコピーされるテーブル ("スナップショット") の確認や、継続レプリケーションモードのテーブル ("レプリケート") を確認できます。

Azure Synapse ワークスペースの [監視] ハブに移動し、[リンク接続] を選びます。
開始したリンク接続を開き、各テーブルの状態を表示します。
接続の監視ビューで [最新の情報に更新] を選択して、状態が更新を確認します。

レプリケートされたデータにクエリを実行する

数分待ってから、予期されるテーブルとデータがターゲットデータベースにあることを確認します。 Azure Synapse SQL 専用プールの保存先ストアで使用可能なデータを確認します。ここで、ターゲット Azure Synapse SQL 専用プール内のレプリケートされたテーブルを調べることもできます。

[データ] ハブの [ワークスペース] で、ターゲットデータベースを開きます。
[テーブル] でターゲットテーブルのいずれかを右クリックします。
[新しい SQL スクリプト] を選択してから [上位 100 行] を選びます。
このクエリを実行して、ターゲット Azure Synapse SQL 専用プール内のレプリケートされたデータを表示します。
Microsoft SQL Server Management Studio (SSMS) またはその他のツールを使用して、ターゲットデータベースに対してクエリを実行することもできます。ワークスペースの SQL 専用エンドポイントをサーバー名として使用します。この名前は通常、<workspacename>.sql.azuresynapse.net です。 SSMS またはその他のツール経由で接続するときには、追加の接続文字列パラメーターとして Database=databasename@poolname を追加します。

既存の Azure Synapse Link 接続のテーブルを追加または削除する

Synapse Studio でテーブルを追加または削除するには、次の操作を行います。

Azure Synapse ワークスペースで、[統合] ハブを開きます。
編集するリンク接続を選択して開きます。
以下のいずれかを実行します。
- テーブルを追加するには、[新しいテーブル] を選びます。
- テーブルを削除するには、その横にあるごみ箱アイコンを選びます。
注意

リンク接続が実行されているときに、直接、テーブルを追加または削除できます。

Azure Synapse Link 接続を停止する

Synapse Studio で Azure Synapse Link 接続を停止するには、次の操作を行います。

Azure Synapse ワークスペースで、[統合] ハブを開きます。
編集するリンク接続を選択して開きます。
[停止] を選択してリンク接続を停止すると、データのレプリケートが停止します。

注意

リンク接続を停止した後に再び開始すると、ソースデータベースからの完全な初期読み込みから開始され、次に増分変更フィードが行われます。

ランディングゾーンの共有アクセス署名トークンをローテーションする

SQL 変更フィードがランディングゾーンにアクセスし、そこにデータをプッシュするには、共有アクセス署名トークンが必要です。有効期限が設定されているため、その日までにトークンをローテーションする必要があります。そうしないと、Azure Synapse Link が、SQL Server インスタンスから Azure Synapse SQL 専用プールにデータをレプリケートできなくなります。

Azure Synapse ワークスペースで、[統合] ハブを開きます。
編集するリンク接続を選択して開きます。
[Rotate token](トークンのローテーション) を選択します。
新しい共有アクセス署名トークンを取得するには、[自動的に生成] または [手動で入力] を選び、[OK] を選びます。

Note

ストレージからの制限により、生成された SAS トークンを使用してランディングゾーンに接続できない場合は、委任 SAS トークンを使用してランディングゾーンに接続することもできます。

次のステップ

SQL Server 2022 以外のデータベースを使用している場合は、次を参照してください。