サーバー エクスプローラーを使用したストレージ リソースの参照と管理

ヒント

Microsoft Azure Storage Explorerを試す

Microsoft Azure Storage Explorerは、Microsoft から提供されている無料のスタンドアロン アプリです。 Windows、macOS、Linux 上で Azure Storage のデータを視覚的に操作することができます。

Note

この記事は Azure Cloud Services (クラシック) に適用されます。これは新規のお客様向けには非推奨となっており、2024 年 8 月 31 日に廃止されます。 このテクノロジを使用して構築された既存のサービスは、引き続き Azure Cloud Services (延長サポート) を通じてサポートされます。 新しい開発では、Azure App ServiceAzure FunctionsAzure Container Apps など、特定の目的に合わせて設計された新しいサービスの種類を使用することをお勧めします。 利用可能なサービスの最新の一覧については、「Azure 製品のディレクトリ」を参照してください。

Microsoft Visual Studio 2019 用の Azure ワークロードをインストール済みである場合、Azure のストレージ アカウントから、BLOB、キュー、テーブルのデータを表示できます。 サーバー エクスプローラーの [Azure] の [ストレージ] ノードに、ローカル ストレージ エミュレーター アカウントをはじめとする Azure Storage アカウント内のデータが表示されます。

Visual Studio でサーバー エクスプローラーを表示するには、メニュー バーの [表示]>[サーバー エクスプローラー] を選択します。 [ストレージ] ノードには、接続先の各 Azure サブスクリプションまたは証明書に存在するすべてのストレージ アカウントが表示されます。 ストレージ アカウントが表示されない場合は、 この記事の最後に記載した手順で追加できます。

Visual Studio 2019 以前では、Cloud Explorer を使用して Azure リソースを表示および管理することもできます。 詳細については、Cloud Explorer を使用した Azure リソースの管理に関する記事をご覧ください。

重要

Cloud Explorer は、Visual Studio 2022 では廃止されています。 代わりに、次の代替手段を使用します。

  • Azure App Services または Azure 関数アプリをデバッグするには、すべてのプロジェクトで利用できる Connected Services または Publish 機能を利用できます。
    • Visual Studio を利用して公開する場合、[ホスティング] セクションの "追加オプション" の下でこの機能を利用できます。
    • 公開機能を使用しない場合、ソリューションの各プロジェクト内の [接続されたサービス] ノードは、Azure リソースへのアクセスを構成したり、リモート デバッグ、リモート プロファイル、アプリケーションの開始/停止、ストリーミング ログの表示など、さまざまな操作を呼び出したりする際に役立ちます。
  • Microsoft から提供されている無料のスタンドアロン アプリの Microsoft Azure Storage Explorer を使用します。 Windows、macOS、Linux 上で Azure Storage のデータを視覚的に操作することができます。
  • Kudu コンソールは、App Service サーバーとそのファイル システムに直接アクセスするための昇格されたコマンド ライン アクセスを提供します。 これは、重要なデバッグ ツールであると同時に、これでパッケージのインストールなどの CLI 操作を実行できます。

必要に応じて、Azure Portal を使用するか、サーバー エクスプローラーで以前のバージョンの Visual Studio の Azure ノードを引き続き使用します。

Visual Studio 2022 の詳細については、リリース ノートを参照してください。

前提条件

Visual Studio でのストレージ リソースの表示と管理

サーバー エクスプローラーには、ストレージ エミュレーター アカウント内の BLOB、キュー、テーブルの一覧が自動的に表示されます。 ストレージ エミュレーター アカウントは、サーバー エクスプローラーの [ストレージ] ノードの下に [開発] ノードとして表示されます。

ストレージ エミュレーター アカウントのリソースを表示するには、 [開発] ノードを展開します。 [開発] ノードを展開したとき、まだストレージ エミュレーターが起動していない場合は、自動的に起動します。 このプロセスには数秒かかる場合があります。 ストレージ エミュレーターの起動中、Visual Studio の他の領域では作業を続行できます。

ストレージ アカウントのリソースを表示するには、サーバー エクスプローラーでストレージ アカウントのノードを展開します。展開すると、[BLOB][キュー]、および [テーブル] ノードが表示されます。

BLOB リソースの操作

[BLOB] ノードには、選択したストレージ アカウントのコンテナーの一覧が表示されます。 BLOB コンテナーには BLOB ファイルが含まれており、これらの BLOB をフォルダーとサブフォルダーにまとめることができます。 詳細については、「 .NET から BLOB ストレージを使用する方法」を参照してください。

BLOB コンテナーを作成するには

  1. [BLOB] ノードのショートカット メニューを開き、[BLOB コンテナーの作成] を選択します。

  2. [BLOB コンテナーの作成] ダイアログ ボックスで新しいコンテナーの名前を入力します。

  3. キーボードの Enter キーを押すか、名前フィールドの外側をクリックまたはタップして BLOB コンテナーを保存します。

    Note

    BLOB コンテナーの名前は、数字 (0 ~ 9) または小文字の英字 (a ~ z) で始める必要があります。

BLOB コンテナーを削除するには

削除する BLOB コンテナーのショートカット メニューを開き、[削除] を選択します。

BLOB コンテナー内の項目の一覧を表示するには

一覧で BLOB コンテナー名のショートカット メニューを開き、[開く] を選択します。

表示した BLOB コンテナーの内容は、BLOB コンテナー ビューと呼ばれるタブに表示されます。

BLOB コンテナー ビュー

BLOB コンテナー ビューの右上隅にあるボタンを使用して、BLOB に対して次の操作を実行できます。

  • フィルター値を入力して適用する
  • コンテナー内の BLOB の一覧を更新する
  • ファイルをアップロードします。
  • BLOB を削除する (BLOB コンテナーからファイルを削除しても、基になるファイルは削除されません。BLOB コンテナーから除去されるだけです。)
  • BLOB を開く
  • BLOB をローカル コンピューターに保存する

BLOB コンテナーにフォルダーまたはサブフォルダーを作成するには

  1. Cloud Explorer で BLOB コンテナーを選択します。 コンテナー ウィンドウで [BLOB のアップロード] をクリックします。

  2. [新しいファイルのアップロード] ダイアログ ボックスで、[参照] をクリックしてアップロードするファイルを指定し、[フォルダー (省略可)] ボックスにフォルダー名を入力します。

    Uploading a file into a blob folder

    同じ手順に従って、コンテナーのフォルダーにサブフォルダーを追加できます。 フォルダー名を指定していない場合、ファイルは BLOB コンテナーの最上位にアップロードされます。 コンテナー内の指定したフォルダーにファイルが表示されます。

    Folder added to a blob container

  3. フォルダーをダブルクリックするか、Enter キーを押してフォルダーの内容を表示します。 コンテナーのフォルダー内で、[親ディレクトリを開く] (矢印) ボタンをクリックすると、コンテナーのルートに戻ることができます。

コンテナーのフォルダーを削除するには

フォルダー内のファイルをすべて削除します。

BLOB コンテナー内のフォルダーは仮想フォルダーであるため、空のフォルダーを作成することはできません。 また、フォルダーを削除してそのファイルの内容を削除することはできません。フォルダー自体を削除するには、フォルダーの内容をすべて削除する必要があります。

コンテナー内の BLOB をフィルター処理するには

共通のプレフィックスを指定すると、表示される BLOB をフィルター処理できます。

たとえば、フィルター テキスト ボックスに hello というプレフィックスを入力し、[実行] (!) ボタンをクリックすると、"hello" で始まる BLOB だけが表示されます。

フィルター テキスト ボックス

フィルター テキスト ボックスでは大文字と小文字が区別され、ワイルド カード文字によるフィルター処理はサポートされていません。 BLOB はプレフィックスでのみフィルター処理できます。 仮想階層で区切り記号を使用して BLOB を整理している場合は、プレフィックスに区切り記号を含めることができます。 たとえば、"HelloFabric/" というプレフィックスでフィルター処理すると、この文字列で始まるすべての BLOB が返されます。

BLOB データをダウンロードするには

Cloud Explorer で次のいずれかの方法を使用します。

  • 1 つ以上の BLOB のショートカット メニューを開き、[開く] を選択します。
  • BLOB 名を選択し、[開く] をクリックします。
  • BLOB 名をダブルクリックします。

BLOB のダウンロードの進行状況が [Azure のアクティビティ ログ] ウィンドウに表示されます。

その種類のファイルの既定のエディターで BLOB が開きます。 オペレーティング システムによってファイルの種類が認識された場合は、ローカルにインストールされているアプリケーションでファイルが開きます。 それ以外の場合は、BLOB のファイルの種類に適したアプリケーションを選択するよう求められます。 BLOB をダウンロードしたときに作成されるローカル ファイルは、読み取り専用としてマークされます。

BLOB データはローカルにキャッシュされ、Azure Blob Storage での BLOB の最終更新時刻に照らしてチェックされます。 BLOB が前回のダウンロード後に更新されている場合は、再度ダウンロードされます。 それ以外の場合は、ローカル ディスクから BLOB が読み込まれます。

既定では、BLOB が一時ディレクトリにダウンロードされます。 特定のディレクトリに BLOB をダウンロードするには、選択した BLOB 名のショートカット メニューを開き、[名前を付けて保存] を選択します。 この方法で BLOB を保存すると、BLOB ファイルは開かれず、読み取り/書き込み属性のローカル ファイルが作成されます。

BLOB をアップロードするには

BLOB をアップロードするには、コンテナーを開き、BLOB コンテナー ビューに表示されたら、[BLOB のアップロード] をクリックします

アップロード対象ファイル (複数可) を選択し、任意の種類のファイルをアップロードできます。 [Azure のアクティビティ ログ] ウィンドウにアップロードの進行状況が表示されます。 BLOB データを操作する方法の詳細については、.NET で Azure Blob Storage を使用する方法に関する記事をご覧ください。

BLOB に転送されたログを表示するには

Azure Diagnostics を使用して Azure アプリケーションのデータをログに記録し、ログをストレージ アカウントに転送した場合、Azure によってこれらのログ用に作成されたコンテナーが表示されます。 サーバー エクスプローラーでこれらのログを表示すれば、アプリケーション、特に Azure にデプロイされたアプリケーションの問題を簡単に特定できます。

Azure Diagnostics の詳細については、「 Azure Diagnostics を使用したログ データの収集」を参照してください。

BLOB の URL を取得するには

BLOB のショートカット メニューを開き、[URL のコピー] を選択します。

BLOB を編集するには

BLOB を選択し、 [BLOB を開く] ボタンを選択します。

ファイルは一時的な場所にダウンロードされ、ローカル コンピューター上で開かれます。 変更を行ってから、BLOB を再アップロードします。

キュー リソースの操作

ストレージ サービスのキューは、Azure Storage アカウント内でホストされています。 これらのキューを使用すると、メッセージを渡すメカニズムによって、クラウド サービス ロールが相互にやり取りしたり、他のサービスとやり取りしたりすることができます。 キューは、クラウド サービス、および外部クライアントの Web サービスからプログラムによってアクセスできます。 キューは、Visual Studio のサーバー エクスプローラーを使用して直接アクセスすることもできます。

キューを使用するクラウド サービスを開発する場合は、コードを開発およびテストするときに、Visual Studio を使用してキューを対話的に作成したり操作したりすることができます。

サーバー エクスプローラーでは、ストレージ アカウント内のキューを表示したり、キューを作成 (または削除) したりすることができるほか、キューを開いてメッセージを表示したり、メッセージをキューに追加したりすることができます。 キューを閲覧用に開くと、個々のメッセージを表示できます。また、左上隅のボタンを使用して、キューに対して次の操作を実行できます。

  • キューの表示を更新する
  • メッセージをキューに追加します。
  • 最上位のメッセージをデキューする
  • キュー全体をクリアする

次の画像は、2 つのメッセージを含むキューを示しています。

キューの表示

ストレージ サービスのキューの詳細については、「.NET を使用して Azure Queue Storage を使用する」をご覧ください。 ストレージ サービス キューの Web サービスについては、Queue Storage の概念を参照してください。 Visual Studio を使用して、ストレージ サービス キューにメッセージを送信する方法については、「 ストレージ サービスのキューにメッセージを送信する」を参照してください。

注意

ストレージ サービスのキューは、Azure Service Bus キューとは異なります。 Service Bus キューの詳細については、「Service Bus のキュー、トピック、サブスクリプション」をご覧ください。

テーブル リソースの操作

Azure Table Storage は、大量の構造化データを格納します。 このサービスは、Azure クラウドの内部および外部からの認証された呼び出しを受け付ける NoSQL データストアです。 Azure のテーブルは、構造化された非リレーショナル データを格納するのに最適です。

テーブルを作成するには

  1. Cloud Explorer でストレージ アカウントの [テーブル] ノードを選択し、 [テーブルの作成] を選択します。
  2. [テーブルの作成] ダイアログ ボックスでテーブルの名前を入力します。

テーブル データを表示するには

  1. Cloud Explorer[Azure] ノードを開き、 [Storage] ノードを開きます。

  2. 目的のストレージ アカウント ノードを開き、 [テーブル] ノードを開いて、そのストレージ アカウントのテーブルの一覧を表示します。

  3. テーブルのショートカット メニューを開き、[テーブルの表示] を選択します。

    An Azure table in Solution Explorer

テーブルは、エンティティ (行に表示) とプロパティ (列に表示) で構成されています。 たとえば、次の図はテーブル デザイナーに一覧表示されたエンティティを示しています。

テーブル データを編集するには

テーブル デザイナーで、エンティティ (単一の行) またはプロパティ (単一のセル) のショートカット メニューを開き、 [編集] を選択します。

テーブル エンティティの追加または編集

単一テーブルのエンティティが、同じ一連のプロパティ (列) を持っている必要はありません。 テーブル データの表示と編集には、次の制限があることに留意してください。

  • バイナリ データ (type byte[]) は、表示することも編集することもできませんが、テーブルに格納することは可能です。
  • PartitionKeyRowKey の値は編集できません。この操作は、Azure Table Storage ではサポートされていません。
  • Timestamp という名前のプロパティは作成できません。 Azure Storage サービスでこの名前のプロパティが使用されています。
  • DateTime 値を入力する場合は、ご使用のコンピューターの地域と言語の設定に適した形式に従う必要があります (たとえば、英語 (米国) の場合は、MM/DD/YYYY HH:MM:SS [AM|PM])。

エンティティを追加するには

  1. テーブル デザイナー[エンティティの追加] ボタンを選択します。

    [エンティティの追加] ボタン

  2. [エンティティの追加] ダイアログ ボックスで、PartitionKey プロパティおよび RowKey プロパティの値を入力します。

    [エンティティの追加] ダイアログ ボックス

    値は慎重に入力してください。 ダイアログ ボックスを閉じた後に値を変更することはできません。変更するには、エンティティを削除し、追加し直す必要があります。

エンティティをフィルター処理するには

クエリ ビルダーを使用する場合、テーブルに表示されるエンティティ セットをカスタマイズすることができます。

  1. クエリ ビルダーを開くには、テーブルを閲覧用に開きます。

  2. テーブル ビューのツール バーの [クエリ ビルダー] をクリックします。

    [クエリ ビルダー] ダイアログ ボックスが表示されます。 次の図は、クエリ ビルダーで作成しているクエリを示しています。

    クエリ ビルダー

  3. クエリの作成を終えたら、ダイアログ ボックスを閉じます。 クエリの結果であるテキスト形式が WCF Data Services フィルターとしてテキスト ボックスに表示されます。

  4. クエリを実行するには、緑の三角形のアイコンをクリックします。

また、フィルター テキスト ボックスに WCF Data Services フィルター文字列を直接入力することで、テーブル デザイナーに表示されるエンティティ データをフィルター処理することもできます。 この種の文字列は、SQL の WHERE 句に似ていますが、サーバーには HTTP 要求として送信されます。 フィルター文字列を作成する方法の詳細については、「テーブル デザイナー用のフィルター文字列の作成」を参照してください。

有効なフィルター文字列の例を次の図に示します。

フィルター文字列

ストレージ データの更新

サーバー エクスプローラーでストレージ アカウントに接続したり、ストレージ アカウントからデータを取得したりする場合、操作が完了するまでに最大で 1 分かかることがあります。 サーバー エクスプローラーが接続できない場合、操作がタイムアウトする可能性があります。データの取得中、Visual Studio の他の部分では作業を続行できます。 操作に時間がかかりすぎる場合に操作を取り消すには、サーバー エクスプローラー ツール バーの [更新の中止] をクリックします。

BLOB コンテナー データを更新するには

  • [ストレージ] の下の [BLOB] ノードを選択し、サーバー エクスプローラー ツール バーの [最新の情報に更新] をクリックします。
  • 表示されている BLOB の一覧を更新するには、[実行] をクリックします。

テーブル データを更新するには

  • [ストレージ] の下の [テーブル] ノードを選択し、サーバー エクスプローラー ツール バーの [最新の情報に更新] をクリックします。
  • テーブル デザイナーに表示されているエンティティの一覧を更新するには、テーブル デザイナーで [実行] ボタンを選択します。

キュー データを更新するには

[ストレージ] の下の [キュー] ノードを選択し、サーバー エクスプローラー ツール バーの [最新の情報に更新] をクリックします。

ストレージ アカウントのすべてのアイテムを更新するには

アカウント名を選択し、サーバー エクスプローラーのツール バーの [最新の情報に更新] をクリックします。

サーバー エクスプローラーを使用してストレージ アカウントを追加する

サーバー エクスプローラーを使用してストレージ アカウントを追加する方法は 2 つあります。 Azure サブスクリプションでストレージ アカウントを作成することも、既存のストレージ アカウントを接続することもできます。

サーバー エクスプローラーを使用してストレージ アカウントを作成するには

  1. サーバー エクスプローラーで [ストレージ] ノードのショートカット メニューを開き、[ストレージ アカウントの作成] を選択します。

  2. [ストレージ アカウントの作成] ダイアログ ボックスで、次の情報を選択または入力します。

    • ストレージ アカウントを追加する Azure サブスクリプション。
    • 新しいストレージ アカウントに使用する名前。
    • リージョンまたはアフィニティ グループ (米国西部や東アジアなど)。
    • ローカル冗長など、ストレージ アカウントで使用するレプリケーションの種類。

    Azure Storage アカウントの作成

  3. [作成] を選択します

新しいストレージ アカウントがソリューション エクスプローラーの [Storage] ボックスの一覧に表示されます。

サーバー エクスプローラーを使用して既存のストレージ アカウントを接続するには

  1. サーバー エクスプローラーで、[Azure] の [ストレージ] ノードのショートカット メニューを開き、[外部ストレージのアタッチ] を選択します。

    Adding an existing storage account

  2. [ストレージ アカウントの作成] ダイアログ ボックスで、次の情報を選択または入力します。

    • 接続する既存のストレージ アカウントの名前。
    • 選択したストレージ アカウントのキー。 この値は通常、ストレージ アカウントを選択したときに提供されます。 ストレージ アカウント キーを Visual Studio に記憶させる場合は、[アカウント キーを記憶する] チェックボックスをオンにします。
    • HTTP、HTTPS、カスタム エンドポイントなど、ストレージ アカウントへの接続に使用するプロトコル。 カスタム エンドポイントの詳細については、接続文字列の構成方法に関する記事をご覧ください。

セカンダリ エンドポイントを表示するには

[読み取りアクセス Geo 冗長] レプリケーション オプションを使用してストレージ アカウントを作成した場合は、アカウント名のショートカット メニューを開き、[プロパティ] を選択してそのセカンダリ エンドポイントを表示できます。

Storage secondary endpoints

サーバー エクスプローラーからストレージ アカウントを削除するには

サーバー エクスプローラーでアカウント名のショートカット メニューを開き、[削除] を選択します。

ストレージ アカウントを削除すると、そのアカウントに関して保存されていたキー情報もすべて削除されます。

サーバー エクスプローラーからストレージ アカウントを削除しても、ストレージ アカウントやアカウントに含まれているデータには影響しません。 サーバー エクスプローラーからの参照が削除されるだけです。 ストレージ アカウントを完全に削除するには、Azure Portal を使用します。

Azure Storage サービスの使用方法の詳細については、Azure Storage サービスへのアクセスに関するページをご覧ください。