Enable Stretch Database for a table

適用対象: SQL Server 2016 (13.x) 以降 - Windows のみ

Stretch Database 用にテーブルを構成するには、SQL Server Management Studio でテーブルに対して [ストレッチ] > [有効にする] の順に選択し、[テーブルのストレッチの有効化] ウィザードを開きます。 Transact-SQL を使用して、既存のテーブルで Stretch Database を有効にしたり、Stretch Database が有効になっている新しいテーブルを作成することもできます。

• コールド データを別のテーブルに保存している場合は、そのテーブル全体を移行できます。

• テーブルにホット データとコールド データの両方が含まれている場合は、移行する行を選択するフィルター関数を指定できます。

前提条件。 テーブルに対して [ストレッチ] > [有効にする] の順に選択した場合、データベースに対して Stretch Database がまだ有効になっていないと、ウィザードは最初に Stretch Database 用にデータベースを構成します。 この記事の手順ではなく、「Stretch ウィザードに対するデータベースの有効化を実行して開始する」の手順に従います。

権限: データベースまたはテーブルで Stretch Database を有効にするには、db_owner 権限が必要です。 テーブルで Stretch Database を有効にするには、テーブルの ALTER アクセス許可も必要です。

ウィザードを使用する

1. ウィザードを起動する

1. SQL Server Management Studio のオブジェクト エクスプローラーで、ストレッチを有効にするテーブルを選択します。

2. 右クリックして [ストレッチ] > [有効にする] を選び、ウィザードを起動します。

2. はじめに

ウィザードの目的と前提条件を確認します。

3. データベースのテーブルを選択する

有効にするテーブルが表示され、選択されていることを確認します。

テーブル全体を移行することも、ウィザードでフィルター関数を指定することもできます。 移行する行を選択するために別の種類のフィルター関数を使用する場合、次のいずれかの操作を行います。

• ウィザードを終了し、ALTER TABLE ステートメントを実行してテーブルの Stretch を有効にして、フィルター関数を指定します。

• ウィザードを終了した後、ALTER TABLE ステートメントを実行してフィルター関数を指定します。 必要な手順については、「 Add a filter function after running the Wizard」 (ウィザードの実行後、フィルター関数を追加する) を参照してください。

ALTER TABLE 構文については、この記事で後ほど説明します。

4.まとめ

ウィザードで入力した値および選択したオプションを確認します。 次に、 [完了] を選択してストレッチを有効にします。

5. 結果

結果を確認します。

Transact-SQL の使用

Transact-SQL を使用して、既存のテーブルで Stretch Database を有効にしたり、Stretch Database が有効になっている新しいテーブルを作成したりできます。

オプション

CREATE TABLE または ALTER TABLE を実行してテーブルで Stretch Database を有効にする場合は、次のオプションを使用します。

• テーブルにホット データとコールド データの両方が含まれている場合は、オプションで FILTER_PREDICATE = <function> 句を使用して、移行する行を選択する関数を指定します。 この述語でインライン テーブル値関数を呼び出す必要があります。 詳細については、「 フィルター関数を使用して、移行する行を選択する」を参照してください。 フィルター関数を指定しない場合、テーブル全体が移行されます。

  重要

  指定したフィルター関数のパフォーマンスが低いと、データ移行のパフォーマンスも低くなります。 Stretch Database では、CROSS APPLY 演算子を使用してテーブルにフィルター関数を適用します。

• データ移行をすぐに開始する場合は MIGRATION_STATE = OUTBOUND を指定し、データ移行の開始を延期する場合は MIGRATION_STATE = PAUSED を指定します。

既存のテーブルに対して Stretch Database を有効にする

Stretch Database 用に既存のテーブルを構成するには、ALTER TABLE コマンドを実行します。

次の例では、テーブル全体を移行し、データ移行をすぐに開始します。

USE [<Stretch-enabled database name>];
GO
ALTER TABLE [<table name>]
    SET ( REMOTE_DATA_ARCHIVE = ON ( MIGRATION_STATE = OUTBOUND ) );
GO

次の例では、dbo.fn_stretchpredicate インライン テーブル値関数によって識別される行だけを移行し、データ移行を延期します。 フィルター関数の詳細については、「フィルター関数を使用して、移行する行を選択する」を参照してください。

USE [<Stretch-enabled database name>];
GO
ALTER TABLE [<table name>]
    SET ( REMOTE_DATA_ARCHIVE = ON (
        FILTER_PREDICATE = dbo.fn_stretchpredicate(),
        MIGRATION_STATE = PAUSED ) );
GO

詳細については、「 ALTER TABLE (Transact-SQL)」をご覧ください。

Stretch Database が有効になっている新しいテーブルを作成する

Stretch Database が有効になっている新しいテーブルを作成するには、CREATE TABLE コマンドを実行します。

次の例では、テーブル全体を移行し、データ移行をすぐに開始します。

USE [<Stretch-enabled database name>];
GO
CREATE TABLE [<table name>]
    (
        col1 int
        /* replace the sample "col1" column shown above, with the actual list of columns */
    )
    WITH ( REMOTE_DATA_ARCHIVE = ON ( MIGRATION_STATE = OUTBOUND ) );
GO

次の例では、dbo.fn_stretchpredicate インライン テーブル値関数によって識別される行だけを移行し、データ移行を延期します。 フィルター関数の詳細については、「フィルター関数を使用して、移行する行を選択する」を参照してください。

USE [<Stretch-enabled database name>];
GO
CREATE TABLE [<table name>]
    (
        col1 int
        /* replace the sample "col1" column shown above, with the actual list of columns */
    )
    WITH ( REMOTE_DATA_ARCHIVE = ON (
        FILTER_PREDICATE = dbo.fn_stretchpredicate(),
        MIGRATION_STATE = PAUSED ) );
GO

詳細については、「 CREATE TABLE (Transact-SQL)」をご覧ください。

関連項目

• ALTER TABLE (Transact-SQL)
• CREATE TABLE (Transact-SQL)