PowerShell での SQL Server 識別子の使用

コンピュータ名

SQLSERVER:\SQL に続く最初のノードは、データベース エンジンのインスタンスが実行されているコンピュータの名前です (たとえば、SQLSERVER:\SQL\MyComputer)。データベース エンジンのインスタンスと同じコンピュータ上で Windows PowerShell を実行している場合は、コンピュータ名の代わりに localhost または (local) を使用できます。localhost または (local) が使用されたスクリプトは、異なるコンピュータ名を反映するための変更を加えることなく、すべてのコンピュータ上で実行できます。たとえば、次のコマンドは、ローカル コンピュータ上の既定のインスタンスの AdventureWorks サンプル データベースを表します。

Set-Location SQLSERVER:\SQL\localhost\DEFAULT\Databases\AdventureWorks

通常、(local) に使用されているかっこ文字は、Windows PowerShell でコマンドとして扱われます。このため、次のいずれかの作業を行う必要があります。

• パス文字列を引用符で囲みます。

  Set-Location "SQLSERVER:\SQL\(local)\DEFAULT\Databases\AdventureWorks"
  

• バック チック文字 (') を使用して、かっこをエスケープします。

  Set-Location SQLSERVER:\SQL\`(local`)\DEFAULT\Databases\AdventureWorks
  

• 16 進表現を使用して、かっこをエンコードします。

  Set-Location SQLSERVER:\SQL\%28local%29\DEFAULT\Databases\AdventureWorks
  

文字のエスケープとエンコードについては、このトピックの後半で詳しく説明します。

Windows PowerShell スクリプトでは、ピリオド (.) を使用してローカル コンピュータを指定することはできません。Windows PowerShell ではピリオドはコマンドとして解釈されるため、ピリオドはサポートされません。

既定のインスタンス名

データベース エンジンの実行可能プログラムの複数のインスタンスを、同じコンピュータで実行できます。データベース エンジンのインスタンスは、コンピュータ名とインスタンス名の組み合わせ (MyComputer\MyInstance など) で識別されます。

各コンピュータでは、データベース エンジンの既定のインスタンスを 1 つだけ使用できます。既定のインスタンスには、そのインストール時に名前を指定しません。接続文字列にコンピュータ名のみを指定すると、そのコンピュータの既定のインスタンスに接続されます。コンピュータ上のその他すべてのインスタンスは、名前付きインスタンスにする必要があります。インスタンス名はセットアップ時に指定します。接続文字列には、コンピュータ名とインスタンス名の両方を指定する必要があります。

SQL Server プロバイダでは、常にインスタンス名を指定する必要があります。既定のインスタンスには、DEFAULT というインスタンス名を指定する必要があります。

Windows PowerShell パス内の SQL Server 識別子

Windows PowerShell プロバイダは、Windows ファイル システムで使用されるようなパス構造を使用してデータ階層を公開します。SQL Server プロバイダは、SQL Server オブジェクトへのパスを実装します。データベース エンジンについては、ドライブが SQLSERVER: に、最初のフォルダが \SQL に設定され、データベース オブジェクトがコンテナおよびアイテムとして参照されます。これは、データベース エンジンの既定のインスタンスにある AdventureWorks データベースの Purchasing スキーマ内の Vendor テーブルへのパスです。

SQLSERVER:\SQL\MyComputer\DEFAULT\Databases\AdventureWorks\Tables\Purchasing.Vendor

SQL Server 識別子は、テーブル名や列名などの SQL Server オブジェクトの名前です。SQL Server 識別子には 2 つの種類があります。

• 標準識別子には、Windows PowerShell パスでもサポートされている一連の文字のみを使用できます。これらの名前は、変更することなく Windows PowerShell パスで使用できます。

• 区切られた識別子には、Windows PowerShell パス名ではサポートされない文字を使用できます。区切られた識別子には、角かっこで囲まれた識別子 ([IdentifierName]) と二重引用符で囲まれた識別子 ("IdentifierName") があります。区切られた識別子に Windows PowerShell パスではサポートされない文字を使用する場合は、識別子をコンテナ名またはアイテム名として使用する前に、その文字をエンコードまたはエスケープする必要があります。エンコードはすべての文字に有効です。コロン (:) などの一部の文字は、エスケープできません。

識別子のエンコードとデコード

Set-Location Table%3ATest

Set-Location (Encode-SqlName "Table:Test")

文字のエスケープ

cd SQLSERVER:\SQL\MyComputer\MyInstance\MyDatabase\MySchema\`#MyTempTable

コマンドレットでの SQL Server 識別子

SQL Server コマンドレットには、識別子を入力として使用するパラメータを持つものがあります。このパラメータの値は、通常、引用符で囲まれた文字列定数として指定されるか、文字列変数で指定されます。識別子を文字列定数または文字列変数で指定すると、Windows PowerShell でサポートされる一連の文字と競合することがありません。

関連項目

概念