> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sync.cdata.com/llms.txt
> Use this file to discover all available pages before exploring further.
# SQL Server
export const CommonDatasourceAuthenticate = () => {
return コネクタを追加したら、必要なプロパティを設定します。
;
};
export const CommonDatasourceCompleteConnectionOauth = ({datasource = "the data source", title = "the connector", oauthschemes = "", start = 2}) => {
return
- Advanced タブで詳細な接続設定を定義します。（ただし、ほとんどの場合、これらの設定は不要です。）
- {oauthschemes ? <>{oauthschemes} で認証する場合は、 : <>}{datasource} への接続をクリックして {title} アカウントに接続します。
- 作成およびテストをクリックして接続を作成します。
;
};
export const CommonDatasourceMoreInformation = ({datasource = "the data source", advancedurl = "", siteName = "CData Sync", driverVersion = ""}) => {
return <>
{siteName} と{datasource} の連携について、詳しくは{' '}
{datasource} Connector for {siteName}
を参照してください。
;
};
export const CommonAuthSchemeAzureserviceprincipalcert = () => {
return <>
Azure サービスプリンシパルとクライアント証明書で接続するには、次のプロパティを設定します：
- Auth Scheme：AzureServicePrincipalCert を選択。
- Azure Tenant：接続するMicrosoft Online テナントを入力。
- OAuth Client Id：OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- OAuth JWT Cert：Java web token（JWT）証明書ストアを入力。
- OAuth JWT Cert Type：JWT 証明書を格納するキーストアの種類を入力。デフォルトの種類はPEMKEY_BLOB です。
- （オプション）OAuth JWT Cert Password：OAuth JWT 証明書のパスワードを入力。
- （オプション）OAuth JWT Cert Subject：OAuth JWT 証明書のサブジェクトを入力。
アプリケーションのOAuth 証明書を取得するには：
- Azure ポータルにログインします。
- 左ナビゲーションペインですべてのサービスを選択します。次にアプリの登録を検索し選択します。
- 新規登録をクリックします。
- アプリケーションの名前を入力して任意のAzure AD ディレクトリ - マルチテナントを選択します。
- アプリケーションを作成したら、概要セクションに表示されるアプリケーション (クライアント) ID の値をコピーします。この値をOAuth クライアントId として使用します。
- 証明書とシークレットセクションに移動して、証明書のアップロードを選択します。次に、ローカルマシンからアップロードする証明書を選択します。
- 有効期間を指定してクライアントシークレットを保存します。保存するとキーの値が表示されます。
- 値は一度しか表示されないので、コピーしておきます。この値をOAuth クライアントシークレットとして使用します。
- 認証タブで、必ずアクセストークン (暗黙的なフローに使用) を選択します。
;
};
export const CommonAuthSchemeAzureserviceprincipal = () => {
return <>
Azure サービスプリンシパルとクライアントシークレットで接続するには、次のプロパティを設定します：
- Auth Scheme：AzureServicePrincipal を選択。
- Azure Tenant：接続するMicrosoft Online テナントを入力。
- OAuth Client Id：OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントId を入力。
- OAuth Client Secret：OAuth 認証サーバーにアプリケーションを登録した際に割り当てられたクライアントシークレットを入力。
アプリケーションのOAuth クライアントId およびクライアントシークレットを取得するには：
- Azure ポータルにログインします。
- 左ナビゲーションペインですべてのサービスを選択します。次にアプリの登録を検索し選択します。
- 新規登録をクリックします。
- アプリケーションの名前を入力して任意のAzure AD ディレクトリ - マルチテナントを選択します。
- アプリケーションを作成したら、概要セクションに表示されるアプリケーション (クライアント) ID の値をコピーします。この値をOAuth クライアントId として使用します。
- 証明書とシークレットセクションに移動して、アプリケーションの新しいクライアント シークレットを選択します。
- 有効期間を指定してクライアントシークレットを保存します。保存するとキーの値が表示されます。
- 値は一度しか表示されないので、コピーしておきます。この値をOAuth クライアントシークレットとして使用します。
- 認証タブで、必ずアクセストークン (暗黙的なフローに使用) を選択します。
;
};
export const CommonAuthSchemeAzuremsi = ({siteName = "CData Sync"}) => {
return <>
Azure 仮想マシン上で{siteName} が実行されている場合にAzure マネージドサービスID（MSI）を利用するには、Auth Scheme でAzure MSI を選択します。追加のプロパティは必要ありません。
;
};
export const CommonAuthSchemeAzuread = ({siteName = "CData Sync"}) => {
return <>
Azure Active Directory（AD）ユーザーアカウントで接続するには、Auth Scheme でAzureAD を選択します。{siteName} は、接続するための組み込みOAuth アプリケーションを提供するため、追加のプロパティは必要ありません。
;
};
export const CommonDatasourceAddConnector = ({datasource = "the data source", title = "the connector", destination = false, siteNameShort = "Sync"}) => {
return <>
{siteNameShort} で{datasource} のデータを使用できるようにするには、まず以下の手順でコネクタを追加する必要があります：
- {siteNameShort} のダッシュボードから接続ページを開きます。
- 接続を追加をクリックしてコネクタを選択ページを開きます。
-
{destination ? "同期先" : "データソース"}タブをクリックして
{title} 行に移動します。
-
行末にある接続を設定アイコンをクリックして、新しい接続ページを開きます。この操作により、{' '}
接続を追加ダイアログボックスが開きます。
Note： 接続を設定アイコンが表示されない場合は、コネクタをダウンロードアイコンをクリックして {title} コネクタをインストールしてください。
- 接続を追加ダイアログボックスに接続名を入力します。
- 追加をクリックして、コネクタの設定タブを開きます。
新しいコネクタのインストールについての詳細は、{' '}
接続を参照してください。
;
};
export const CommonDatasourceIntroSource = ({datasource = "the data source", siteName = "CData Sync"}) => {
return
{siteName} アプリケーションから{datasource} コネクタを使用して、{datasource} からデータを取得してサポートされている任意の同期先に移動できます。これを行うには、コネクタを追加し、コネクタへの認証を行い、接続を完了する必要があります。
;
};
export const driverVersion = "M";
export const siteNameShort = "Sync";
export const siteName = "CData Sync";
export const datasource = "SQL Server";
export const pageTitle = "SQL Server";
export const advancedurl = "RU";
export const oauthschemes = "AzurePassword, AzureAD, AzureMSI, AzureServicePrincipal, or AzureServicePrincipalCert";
## {datasource} コネクタを追加する
## {datasource} への認証
{siteName} は、いくつかの方法で{datasource} への認証をサポートしています。以下から認証方法を選択し、認証の詳細を含む該当セクションに進みます。
* [**Password**](#password)（デフォルト）
* [**NTLM**](#ntlm)
* [**Kerberos**](#kerberos)
* [**AzurePassword**](#azurepassword)
* [**AzureAD**](#azure-active-directory)
* [**AzureMSI**](#azure-managed-service-identity)
* [**AzureServicePrincipal**](#azure-service-principal)
* [**AzureServicePrincipalCert**](#azure-service-principal-certificate)
### Password
ユーザー資格情報で接続するには、次のプロパティを指定します：
* **Auth Scheme：** **Password** を選択。
* **User：** {datasource} への認証に使用するユーザー名を入力。
* **Password：** {datasource} への認証に使用するパスワードを入力。
### NTLM
NTLM ユーザー資格情報で接続するには、次のプロパティを指定します：
* **Auth Scheme：** **NTLM** を選択。
* **User：** {datasource} への認証に使用するユーザー名を入力。
* **Password：** {datasource} への認証に使用するパスワードを入力。
* （オプション）**Domain：** Windows（NTLM）セキュリティログイン用のドメイン名を入力。
* （オプション）**NTLM Version：** 使用したいNTLM バージョンを選択。デフォルトバージョンは**1**です。
### Kerberos
Kerberos 資格情報で接続するには、次のプロパティを指定します：
* **Auth Scheme：** **Kerberos** を選択。
* **User：** {datasource} への認証に使用するユーザー名を入力。
* **Password：** {datasource} への認証に使用するパスワードを入力。
* **Kerberos KDC：** Kerberos キー配布センター（KDC）マシンのホスト名またはIP アドレスを入力。
* **Kerberos Realm：** Kerberos への認証に使用するKerberos レルムを入力。
* **Kerberos SPN：** Kerberos ドメインコントローラーのサービスプリンシパル名（SPN）を入力。
* （オプション）**Kerberos Keytab File：** Kerberos キータブファイルの完全なファイルパスを入力。
* （オプション）**Kerberos Ticket Cache：** MIT Kerberos 資格情報キャッシュファイルの完全なファイルパスを入力。
### AzurePassword
Azure ユーザー資格情報で接続するには、次のプロパティを指定します：
* **Auth Scheme：** **AzurePassword** を選択。
* **User：** Azure への認証に使用するユーザー名を入力。
* **Password：** Azure への認証に使用するパスワードを入力。
### Azure Active Directory
### Azure Managed Service Identity
### Azure Service Principal
### Azure Service Principal Certificate
## 接続を完了する
接続を完了するには：
1. **Database** プロパティ（オプション）には、{datasource} に接続する際に接続するデフォルトのデータベースを入力します。
## SQL Server の変更データキャプチャのセットアップ
{datasource} は、ソースデータベースからの変更を追跡する2つの方法をサポートしています：
* **変更データキャプチャ（CDC）：** *変更データキャプチャ*は、テーブルに適用されるすべての変更を追跡し、それらの変更をシャドウ履歴テーブルに記録します。CDC は、主キー（例：**変更の追跡**）のみをキャプチャするのではなく、すべての行データを履歴テーブルに記録します。
* **変更の追跡：** *変更の追跡*は、{siteName} の効率的な追跡メカニズムを提供します。テーブルに変更の追跡を設定すると、ソーステーブルの行に影響を与えるDML 文はすべて、変更された行ごとに変更の追跡テーブルに変更の追跡情報を記録するようになります。
これらのメソッドの両方がテーブルで有効になっている場合、{siteNameShort} はCDC を使用します。
好みの方法をセットアップするには、該当セクションの手順に従ってください。
### CData Sync の変更データキャプチャの有効化
{siteNameShort} の{datasource} データソースでCDC を使用するには、次の前提条件が満たされていることを確認してください：
* CDC が{datasource} データベースで有効になっていること。
* {datasource} エージェントが起動していること。
* あなたがデータベースの`db_owner` 固定データベースロールのメンバーであること。
前提条件を確認したら、次のステートメントを送信してデータベースでCDC を有効化します：
```
USE [DatabaseName];
EXEC sys.sp_cdc_enable_db;
GO
```
個々のテーブルでCDC を有効にするには、次のステートメントを送信します：
```
USE [DatabaseName];
EXEC sys.sp_cdc_enable_table
@source_schema = [SchemaName],
@source_name = [TableName],
@role_name = NULL
GO
```
### CData Sync の変更の追跡の有効化
データベースまたは個々のテーブルで変更の追跡を有効にできます。
データベースで変更の追跡を有効にするには、次のステートメントを送信します：
```
ALTER DATABASE [DatabaseName] SET CHANGE_TRACKING=ON (CHANGE_RETENTION=7 DAYS, AUTO_CLEANUP=ON);
```
CHANGE\_RETENTION パラメータは、変更追跡情報がデータベースに保持される期間を指定します。ベストプラクティスとして、{siteNameShort} がコンフリクトやエラーを解決する時間を確保できるように長めの時間枠を設定します。最後に正常に実行されたジョブが保持期間外であった場合、{siteNameShort} は自動的にテーブル全体を複製し、変更漏れがないことを確認します。
個々のテーブルで変更の追跡を有効にするには、次のステートメントを送信します：
```
ALTER TABLE [SchemaName].[TableName] ENABLE CHANGE_TRACKING;
```
変更の追跡を使用するには、各テーブルに少なくとも1つの主キーが必要です。
### スキーマの変更
ソーステーブルのスキーマ変更を{siteNameShort} がどのように処理するかは、CDC を使用するか変更の追跡を使用するかによって異なります。
#### 変更データキャプチャ
CDC を使用する場合、{siteNameShort} はスキーマ変更後も{datasource} CDC キャプチャインスタンス間のシームレスな移行をサポートし、データ損失やフルリフレッシュなしにレプリケーションを継続できます。
{datasource} は既存のキャプチャインスタンスに新しいカラムを追跡しないため、スキーマ変更は次の手順で行います：
1. ソーステーブルのスキーマを変更します。
2. 新しい`@capture_instance` 名を指定して`sys.sp_cdc_enable_table` ストアドプロシージャを実行し、新しいCDC キャプチャインスタンスを作成します。{datasource} は古いインスタンスと新しいインスタンスを並列で実行します。
次のCDC ジョブ実行の開始時に、{siteNameShort} は新しいキャプチャインスタンスを検出し、新しいインスタンスの開始ログシーケンス番号（`min_lsn`）までのすべての変更が処理されるまで、元のインスタンスからの読み取りを続けます。その後、{siteNameShort} は自動的に新しいキャプチャインスタンスに切り替え、格納されているCDC メタデータを更新します。
{siteNameShort} が移行を完了したら、`sys.sp_cdc_disable_table` を実行して古いキャプチャインスタンスを安全に削除できます。
この機能は、標準CDC レプリケーションおよび[ヒストリーモード](../../getting-started/features#history-mode)を有効にしたCDC レプリケーションでサポートされています。
* {datasource} はテーブルごとに最大2つの同時キャプチャインスタンスをサポートしています。2つを超えるインスタンスが検出された場合、エラーが発生します。
* {siteNameShort} が移行を完了するまで、元のキャプチャインスタンスを削除しないでください。元のインスタンスを早期に削除すると、{siteNameShort} がそこから残りの変更を読み取る必要があるため、ジョブが失敗します。
#### 変更の追跡
変更の追跡を使用すると、{siteNameShort} は、ソーステーブル構造に変更（カラムの追加やデータ型の変更など）が加えられたときに、同期先テーブルを自動的に更新します。
## 差分レプリケーションのサポート
{datasource} データソースは差分レプリケーションをサポートしています。*差分レプリケーション*によりワークロードが大幅に軽減され、帯域幅の使用と同期の遅延が最小限に抑えられます。データを差分ごとに移動させることで、遅いAPI や毎日のクオータに対処する際、非常に高い柔軟性を発揮します。
{datasource} データソースのカラムに基づいて差分チェックカラムを構成する必要があります。
差分レプリケーションの設定方法の詳細は、[差分レプリケーション](../../getting-started/features#差分レプリケーション)を参照してください。
## Always Encrypted Support
{siteName} connects to {datasource} sources by using the CData JDBC driver. The JDBC driver supports `Always Encrypted` columns, which enables {siteNameShort} to read data from columns that use client-side encryption.
When {siteNameShort} reads from `Always Encrypted` columns, the JDBC driver returns decrypted plaintext values instead of binary or hexadecimal representations. This behavior allows encrypted columns to be included in replication workflows without causing read failures.
## 詳細について