Merge pull request #46756 from SnehaGunda/explorer

Adding data explorer doc

Author: GitHubber17

articles/cosmos-db/TOC.yml

@@ -414,38 +414,50 @@ items:
           href: cassandra-import-data.md
   - name: How To Guides
     items:
-    - name: Keys and consistency
-      href: manage-account.md
-    - name: Throughput
-      href: set-throughput.md
-    - name: Firewall support
-      href: firewall-support.md
-    - name: Setup virtual network service endpoint
-      href: vnet-service-endpoint.md
-    - name: Metrics
-      href: use-metrics.md
-    - name: Monitor SLAs
-      href: monitor-accounts.md
-    - name: Back up and restore
-      href: online-backup-and-restore.md
-    - name: Regional failover
-      href: regional-failover.md
-    - name: Diagnostic logging
-      href: logging.md
-    - name: Stored procedures, triggers, and UDFs
-      href: programming.md
-    - name: BulkExecutor overview
+    - name : Manage
+      items:
+      - name: Manage using PowerShell
+        href: manage-account-with-powershell.md
+      - name: Manage using Storage Explorer
+        href: storage-explorer.md
+      - name: Manage using data explorer
+        href: data-explorer.md
+      - name: Manage keys and consistency levels
+        href: manage-account.md
+      - name: Throughput
+        href: set-throughput.md
+      - name: Expire data automatically
+        href: time-to-live.md
+      - name: Diagnostic logging
+        href: logging.md
+    - name : Secure data
+      items:
+      - name: Firewall support
+        href: firewall-support.md
+      - name: Setup virtual network service endpoint
+        href: vnet-service-endpoint.md
+    - name : Monitor
+      items:
+      - name: Monitor with metrics
+        href: use-metrics.md
+      - name: Monitor SLAs
+        href: monitor-accounts.md
+    - name : Backup and restore
+      items:
+      - name: Online backup and restore
+        href: online-backup-and-restore.md
+      - name: Regional failover
+        href: regional-failover.md
+    - name : Automate
+      items:
+      - name: Stored procedures, triggers, and UDFs
+        href: programming.md
+      - name: Multi-master setup
+        href: multi-master-workaround.md
+    - name: Bulk executor library
       href: bulk-executor-overview.md
     - name: Cost-effective reads and writes
       href: key-value-store-cost.md
-    - name: Expire data automatically
-      href: time-to-live.md
-    - name: Manage using PowerShell
-      href: manage-account-with-powershell.md
-    - name: Manage using Storage Explorer
-      href: storage-explorer.md
-    - name: Multi-master setup
-      href: multi-master-workaround.md
   - name: Resources
     items:
     - name: Query cheat sheet

articles/cosmos-db/data-explorer.md

@@ -0,0 +1,52 @@
+---
+title: Use Azure Cosmos DB explorer to manage your data  | Microsoft Docs
+description: Azure Cosmos DB explorer is a standalone web-based interface that allows you to view and manage the data stored in Azure Cosmos DB.
+services: cosmos-db
+author: deborahc
+manager: kfile
+
+ms.service: cosmos-db
+ms.topic: conceptual
+ms.date: 07/16/2018
+ms.author: Deborah.Chen
+
+---
+
+# Use Azure Cosmos DB explorer to manage your data 
+
+Azure Cosmos DB explorer is a standalone web-based interface that allows you to view and manage the data stored in Azure Cosmos DB. Azure Cosmos DB explorer is equivalent to the existing **Data Explorer** tab that is available in Azure portal when you create an Azure Cosmos DB account. The key advantages of Azure Cosmos DB explorer over the existing Data explorer are:
+
+* You have a full screen real-estate to view your data, run queries, stored procedures, triggers, and view their results.  
+
+* You can provide temporary or permanent read or read-write access to your database account and its collections to other users who do not have access to Azure portal or subscription.  
+
+* You can share the query results with other users who do not have access to Azure portal or subscription.  
+
+## Access Azure Cosmos DB explorer
+
+1. Sign in to [Azure Portal](https://portal.azure.com/). 
+
+2. From **All resources**, find and navigate to your Azure Cosmos DB account, select Keys, and copy the **Primary Connection String**.  
+
+3. Go to https://cosmos.azure.com/, paste the connection string and select **Connect**. By using the connection string, you can access the Azure Cosmos DB explorer without any time limits.  
+
+   If you want to provide other users temporary access to your Azure Cosmos DB account, you can do so by using the read-write and read access URLs. 
+
+4. Open the **Data Explorer** blade, select **Open Full Screen**. From the pop-up dialog, you can view two access URLs – **Read-Write** and **Read**. These URLs allow you to share your Azure Cosmos DB account temporarily with other users. Access to the account expires in 24 hours after which you can reconnect by using a new access URL or the connection string. 
+
+   **Read-Write** – When you share the Read-Write URL with other users, they can view and modify the databases, collections, queries, and other resources associated with that specific account.
+
+   **Read** - When you share the read-only URL with other users, they can view the databases, collections, queries, and other resources associated with that specific account. For example, if you want to share results of a query with your teammates who don't have access to Azure portal or your Azure Cosmos DB account, you can provide them with this URL.
+
+   Choose the type of access you'd like to open the account with and click **Open**. After you open the explorer, the experience is same as you had with the Data Explorer tab in Azure portal.   
+
+   ![Open Azure Cosmos DB explorer](./media/data-explorer/open-data-explorer-with-access-url.png)
+
+## Known issues
+
+Currently the **Open Full Screen** experience that allows you to share temporary read-write or read access is not yet supported for Azure Cosmos DB Gremlin and Table API accounts. You can still view your Gremlin and Table API accounts by passing the connection string to Azure Cosmos DB Explorer. 
+
+## Next steps
+Now that you have learned how to get started with Azure Cosmos DB explorer to manage your data, next you can:
+
+* Start defining [queries](sql-api-sql-query-reference.md) using SQL syntax and perform [server side programming](programming.md) by using stored procedures, UDFs, triggers.