Microsoft SQL Server

Foundry を Microsoft SQL Server に接続して、SQL Server データベースと Foundry の間でデータを読み取り、同期します。

サポートされている機能

セットアップ

1. Data Connection アプリケーションを開き、画面の右上にある + New Source を選択します。
2. 利用可能なコネクタタイプから MS SQL Server を選択します。
3. インターネットを介して 直接接続 するか、エージェントランタイムを通して接続 するかを選択します。
4. 以下のセクションの情報を使用して、コネクタのセットアップを続行するための追加の構成プロンプトに従います。

Foundry での コネクタのセットアップ についてさらに学びます。

認証

次の方法で SQL Server に認証できます。

1. ユーザー名とパスワード: ユーザー名とパスワードを提供します。個々のユーザー資格情報ではなく、サービス資格情報を使用することを推奨します。
2. Active Directory Msi*: このオプションは、authentication=ActiveDirectoryMSI JDBC 設定を使用します。オプションで msiClientId を提供することができます。
3. Active Directory Password*: このオプションは、authentication=ActiveDirectoryPassword JDBC 設定を使用します。この設定を使用するには、Active Directory ユーザーのユーザー名とパスワードを提供する必要があります。
4. Active Directory Service Principal*: このオプションは、authentication=ActiveDirectoryServicePrincipal JDBC 設定を使用します。プリンシパル ID（アプリケーションまたはクライアント ID とも呼ばれる）と、そのプリンシパル ID のシークレットを指定する必要があります。

これらの認証モードの詳細については、公式ドキュメント ↗ を参照してください。すべての認証オプションについて、提供されたユーザーとロールがターゲットデータベースに対する必要な特権、およびターゲットテーブルからの読み取りまたは書き込み権限を持っていることを確認してください。

* Azure Active Directory は現在 Microsoft Entra ID ↗ と呼ばれていますが、Microsoft が公開している SQL Server ドライバの JDBC オプションには Active Directory を参照する元の名前が保持されています。

ネットワーキング

Microsoft SQL Server コネクタは、接続する SQL Server インスタンスへのネットワークアクセスを必要とします。SQL Server 接続は通常、ポート 1433 で接続するためにホスト名を使用します。

Foundry から SQL Server への直接接続を有効にするには、Data Connection アプリケーション でソースを設定する際に適切な エグレスポリシー を追加する必要があります。

Azure SQL や AWS RDS などのクラウドサービス上でホストされている SQL Server インスタンスの場合、クラウドプロバイダのコンソールから取得したホスト名のエグレスポリシーを追加する必要があります。

• Azure SQL インスタンスのホスト名を見つけるには、Azure ポータルの Settings > Properties ページに移動し、Server Name フィールドを探します。Azure SQL のホスト名ベースのエグレスポリシーの例: <your-database-name>.database.windows.net (port 1433)
• 解決された IP を見つけるには、コマンドラインから nslookup <your-database-name>.database.windows.net を実行します。最終結果は、このホスト名が Azure で解決する IP アドレスになります。以下は、Azure SQL の IPv4 ベースのエグレスポリシーの例です: x.x.x.x (port 1433)。Azure SQL は複数のホストにロードバランシングを行うため、nslookup コマンドを数回実行し、解決されたすべての IP アドレスを追加する必要があります。

エージェントランタイムを使用して接続する場合、エージェントホストがユーザーの MS SQL Server データベースに接続するために必要なホスト名、IP アドレス、およびポートに対してファイアウォールが開かれていることを確認する必要があります。

接続の詳細

変更データキャプチャ

Microsoft SQL Server ソースは 変更データキャプチャ 同期をサポートしています。

Microsoft SQL Server で変更データキャプチャを有効にするには、以下のようなコマンドを実行してデータベースで CDC を有効にする必要があります。

USE <データベース> -- <データベース>を使用します
GO
EXEC sys.sp_cdc_enable_db -- Change Data Capture を有効にします
GO

次に、変更ログを記録すべき各テーブルで別のコマンドを実行します:

Copied!
1
2
3
4
5
6
7
8
9
-- スキーマ内の特定のテーブルの変更データキャプチャ（CDC）を有効にします。
EXEC sys.sp_cdc_enable_table
    @source_schema = N'<schema>' -- 対象となるスキーマを指定します。
  , @source_name = N'<table_name>' -- 対象となるテーブル名を指定します。
  , @role_name = NULL -- データ変更を取得するロール名。NULLの場合、すべてのユーザーがデータを取得できます。
  , @capture_instance = NULL -- キャプチャインスタンスの名前。NULLの場合、システムが自動的に名前を生成します。
  , @supports_net_changes = 0 -- ネット変更のサポートを指定します。0の場合、ネット変更はサポートされません。
  , @filegroup_name = N'PRIMARY'; -- データ変更が保存されるファイルグループを指定します。
GO -- このコマンドで前のコマンドを実行します。

テーブルに変更データキャプチャが有効化されると、Foundry に同期させることができます。Overview ページに移動し、+ Create CDC sync を選択して新しい変更データキャプチャ同期の作成を開始します。

これらのコマンドや Microsoft SQL Server で変更データキャプチャ (CDC) を使用する方法の詳細については、使用しているバージョンの SQL Server の公式ドキュメント ↗をご覧ください。

変更データキャプチャの権限設定

CDC データを正常に読み取るには、データベースユーザーに十分な権限を与えていることを確認する必要があります。

• 次のクエリを使用して、ユーザーの権限を確認できます。SELECT HAS_PERMS_BY_NAME('cdc', 'SCHEMA', 'EXECUTE') AS HasExecutePermission; 結果は True であれば 1、False であれば 0 が返されます。
• ソースシステム内で次のクエリを実行して不足している権限を付与できます。GRANT EXECUTE ON SCHEMA::cdc TO <USER>;