プラン ガイド プロパティの表示View Plan Guide Properties

適用対象: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse APPLIES TO: yesSQL Server yesAzure SQL Database noAzure Synapse Analytics (SQL DW) noParallel Data Warehouse

SQL Server 2019 (15.x)SQL Server 2019 (15.x) のプラン ガイドのプロパティは、 SQL Server Management StudioSQL Server Management Studio または を使用して表示できます。 Transact-SQLTransact-SQLYou can view the properties of plan guides in SQL Server 2019 (15.x)SQL Server 2019 (15.x) by using SQL Server Management StudioSQL Server Management Studio or Transact-SQLTransact-SQL

このトピックの内容In This Topic

はじめにBefore You Begin

セキュリティSecurity

PermissionsPermissions

カタログ ビューでのメタデータの表示が、ユーザーが所有しているかそのユーザーが権限を許可されている、セキュリティ保護可能なメタデータに制限されます。The visibility of the metadata in catalog views is limited to securables that either a user owns or on which the user has been granted some permission.

SQL Server Management Studio の使用Using SQL Server Management Studio

プラン ガイドのプロパティを表示するにはTo view the properties of a plan guide

  1. プラス記号をクリックして、プロパティを表示するプラン ガイドのあるデータベースを展開し、プラス記号をクリックして [プログラミング] フォルダーを展開します。Click the plus sign to expand the database in which you want to view the properties of a plan guide, and then click the plus sign to expand the Programmability folder.

  2. プラス記号をクリックして [プラン ガイド] フォルダーを展開します。Click the plus sign to expand the Plan Guides folder.

  3. プロパティを表示するプラン ガイドを右クリックし、 [プロパティ] を選択します。Right-click the plan guide of which you want to view the properties and select Properties.

    [プラン ガイドのプロパティ] ダイアログ ボックスに次のプロパティが表示されます。The following properties show in the Plan Guide Properties dialog box.

    [ヒント]Hints
    Transact-SQLTransact-SQL ステートメントに適用されるクエリ ヒントまたはクエリ プランが表示されます。Displays the query hints or query plan to be applied to the Transact-SQLTransact-SQL statement. クエリ プランがヒントとして指定されている場合は、そのプランの XML プラン表示出力が表示されます。When a query plan is specified as a hint, the XML Showplan output for the plan is displayed.

    [無効化]Is disabled
    プラン ガイドの状態が表示されます。Displays the status of the plan guide. 指定できる値は、 [True] および [False] です。Possible values are True and False.

    [名前]Name
    プラン ガイドの名前が表示されます。Displays the name of the plan guide.

    パラメーターParameters
    スコープの種類が SQL または TEMPLATE の場合は、 Transact-SQLTransact-SQL ステートメントに埋め込まれているすべてのパラメーターの名前とデータ型が表示されます。When the scope type is SQL or TEMPLATE, displays the name and data type of all parameters that are embedded in the Transact-SQLTransact-SQL statement.

    [スコープ バッチ]Scope batch
    Transact-SQLTransact-SQL ステートメントを含むバッチ テキストが表示されます。Displays the batch text in which the Transact-SQLTransact-SQL statement appears.

    [スコープ オブジェクト名]Scope object name
    スコープの種類が OBJECT の場合は、 Transact-SQLTransact-SQL ステートメントを含む Transact-SQLTransact-SQL ストアド プロシージャ、ユーザー定義スカラー関数、複数ステートメントのテーブル値関数、または DML トリガーの名前が表示されます。When the scope type is OBJECT, displays the name of the Transact-SQLTransact-SQL stored procedure, user-defined scalar function, multistatement table-valued function, or DML trigger in which the Transact-SQLTransact-SQL statement appears.

    [スコープ スキーマ名]Scope schema name
    スコープの種類が OBJECT の場合は、そのオブジェクトを含むスキーマの名前が表示されます。When the scope type is OBJECT, displays the name of the schema in which the object is contained.

    [スコープの種類]Scope type
    Transact-SQLTransact-SQL ステートメントを含むエンティティの種類が表示されます。Displays the type of entity in which the Transact-SQLTransact-SQL statement appears. これは Transact-SQLTransact-SQL ステートメントとプラン ガイドを照合するコンテキストを示します。This specifies the context for matching the Transact-SQLTransact-SQL statement to the plan guide. 選択できる値は、 OBJECTSQL、および TEMPLATEです。Possible values are OBJECT, SQL, and TEMPLATE.

    StatementStatement
    プラン ガイドの適用対象の Transact-SQLTransact-SQL ステートメントが表示されます。Displays the Transact-SQLTransact-SQL statement against which the plan guide is applied.

  4. [OK] をクリックします。Click OK.

Transact-SQL の使用Using Transact-SQL

プラン ガイドのプロパティを表示するにはTo view the properties of a plan guide

  1. オブジェクト エクスプローラーで、 データベース エンジンDatabase Engineのインスタンスに接続します。In Object Explorer, connect to an instance of データベース エンジンDatabase Engine.

  2. [標準] ツール バーの [新しいクエリ] をクリックします。On the Standard bar, click New Query.

  3. 次の例をコピーしてクエリ ウィンドウに貼り付け、 [実行] をクリックします。Copy and paste the following example into the query window and click Execute.

    -- If a plan guide named "Guide1" already exists in the AdventureWorks2012 database, delete it.  
    USE AdventureWorks2012;  
    GO  
    IF OBJECT_ID(N'Guide1') IS NOT NULL  
       EXEC sp_control_plan_guide N'DROP', N'Guide1';  
    GO  
    -- creates a plan guide named Guide1 based on a SQL statement  
    EXEC sp_create_plan_guide   
        @name = N'Guide1',   
        @stmt = N'SELECT TOP 1 *   
                  FROM Sales.SalesOrderHeader   
                  ORDER BY OrderDate DESC',   
        @type = N'SQL',  
        @module_or_batch = NULL,   
        @params = NULL,   
        @hints = N'OPTION (MAXDOP 1)';  
    GO  
    -- Gets the name, created date, and all other relevant property information on the plan guide created above.   
    SELECT name AS plan_guide_name,  
       create_date,  
       query_text,  
       scope_type_desc,  
       OBJECT_NAME(scope_object_id) AS scope_object_name,  
       scope_batch,  
       parameters,  
       hints,  
       is_disabled  
    FROM sys.plan_guides  
    WHERE name = N'Guide1';  
    GO  
    

詳細については、「sys.plan_guides (Transact-SQL)」を参照してください。For more information, see sys.plan_guides (Transact-SQL).