You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
| Linux |[.deb](https://go.microsoft.com/fwlink/?linkid=2135515)<br>[.rpm](https://go.microsoft.com/fwlink/?linkid=2135268)<br>[.tar.gz](https://go.microsoft.com/fwlink/?linkid=2135267)|July 17, 2020| 1.20.1|
28
28
29
29
For details about the latest release, see the [release notes](release-notes.md).
30
30
@@ -36,32 +36,32 @@ The *user installer* is recommended because it does not require administrator pr
36
36
37
37
**User Installer** (recommended)
38
38
39
-
1. Download and run the [[!INCLUDE[name-sos](../includes/name-sos-short.md)]*user* installer for Windows](https://go.microsoft.com/fwlink/?linkid=2132348).
39
+
1. Download and run the [[!INCLUDE[name-sos](../includes/name-sos-short.md)]*user* installer for Windows](https://go.microsoft.com/fwlink/?linkid=2135512).
40
40
2. Start the [!INCLUDE[name-sos-short](../includes/name-sos-short.md)] app.
41
41
42
42
**System Installer**
43
43
44
-
1. Download and run the [[!INCLUDE[name-sos](../includes/name-sos-short.md)]*system* installer for Windows](https://go.microsoft.com/fwlink/?linkid=2132347).
44
+
1. Download and run the [[!INCLUDE[name-sos](../includes/name-sos-short.md)]*system* installer for Windows](https://go.microsoft.com/fwlink/?linkid=2135513).
45
45
2. Start the [!INCLUDE[name-sos-short](../includes/name-sos-short.md)] app.
46
46
47
47
**.zip file**
48
48
49
-
1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] .zip for Windows](https://go.microsoft.com/fwlink/?linkid=2132518).
49
+
1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] .zip for Windows](https://go.microsoft.com/fwlink/?linkid=2135514).
50
50
2. Browse to the downloaded file and extract it.
51
51
3. Run `\azuredatastudio-windows\azuredatastudio.exe`
52
52
53
53
## Get Azure Data Studio for macOS
54
54
55
-
1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] for macOS](https://go.microsoft.com/fwlink/?linkid=2132519).
55
+
1. Download [[!INCLUDE[name-sos](../includes/name-sos-short.md)] for macOS](https://go.microsoft.com/fwlink/?linkid=2135266).
56
56
2. To expand the contents of the zip, double-click it.
57
57
3. To make Azure Data Studio available in the *Launchpad*, drag *Azure Data Studio.app* to the *Applications* folder.
58
58
59
59
## Get Azure Data Studio for Linux
60
60
61
61
1. Download [!INCLUDE[name-sos](../includes/name-sos-short.md)] for Linux by using one of the installers or the tar.gz archive:
@@ -271,4 +271,4 @@ In dashboard, we provide the following context variables:
271
271
|`serverName`|A string of the server name of the current connection. Ex. `serverName == 'localhost'`.|
272
272
|`databaseName` | A string of the database name of the current connection. Ex. `databaseName == 'master'`.|
273
273
|`connection` | The full connection profile object for the current connection (IConnectionProfile)|
274
-
|`dashboardContext` | A string of the context of the page of the dashboard is currently on. Either 'database' or 'server'. Ex. `dashboardContext == 'database'`|
274
+
|`dashboardContext` | A string of the context of the page the dashboard is currently on. Either 'database' or 'server'. Ex. `dashboardContext == 'database'`|
Copy file name to clipboardExpand all lines: docs/azure-data-studio/extension-authoring.md
+23-15Lines changed: 23 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Create extensions
3
-
description: Learn about creating and adding extensions to Azure Data Studio
3
+
description: Learn about creating and publishing extensions to Azure Data Studio
4
4
ms.prod: azure-data-studio
5
5
ms.technology:
6
6
ms.topic: conceptual
@@ -26,14 +26,16 @@ If you're interested in extending Azure Data Studio, you can create your own ext
26
26
27
27
***Prerequisites***
28
28
29
-
To develop an extension you need Node.js installed and available in your $PATH. Node.js includes npm, the Node.js Package Manager, which will be used to install the extension generator.
29
+
To develop an extension, you need [Node.js](https://nodejs.org/) installed and available in your `$PATH`. Node.js includes npm, the Node.js Package Manager, which will be used to install the extension generator.
30
30
31
-
To start your new extension, you can use the Azure Data Studio Extension generator. The Yeoman [extension generator](https://www.npmjs.com/package/generator-azuredatastudio)makes it very easy to create simple extension projects. To Launch the generator, type the following in a command prompt:
31
+
To create your new extension, you can use the Azure Data Studio Extension Generator. The Yeoman [Extension Generator](https://www.npmjs.com/package/generator-azuredatastudio)is a beneficial starting point for extension projects. To launch the generator, type the following in a command prompt:
32
32
33
-
`npm install -g yo generator-azuredatastudio`
34
-
35
-
`yo azuredatastudio`
33
+
```
34
+
npm install -g yo generator-azuredatastudio # Install the generator
35
+
yo azuredatastudio
36
+
```
36
37
38
+
For an in-depth guide on how to get started with your extension template, see [Creating an Extension](https://docs.microsoft.com/sql/azure-data-studio/tutorial-create-extension?view=sql-server-ver15), which walks you through the creation of a keymap extension.
37
39
38
40
**Extensibility References**
39
41
@@ -45,19 +47,24 @@ To learn about Azure Data Studio Extensibility see [Extensibility overview](exte
45
47
You can debug your new extension using Visual Studio Code extension [Azure Data Studio Debug](https://github.com/kevcunnane/sqlops-debug).
46
48
47
49
Steps
48
-
- Open your extension with [Visual Studio Code](https://code.visualstudio.com/)
49
-
- Install Azure Data Studio Debug extension
50
-
- Press **F5** or click the Debug icon and click **Start**.
51
-
- A new instance of Azure Data Studio starts in a special mode (Extension Development Host) and this new instance is now aware of your extension.
50
+
1. Open your extension with [Visual Studio Code](https://code.visualstudio.com/).
51
+
1. Install the Azure Data Studio Debug extension.
52
+
1. Press **F5** or click the Debug icon and click **Start**.
53
+
1. A new instance of Azure Data Studio starts in a special mode (Extension Development Host) and this new instance is now aware of your extension.
52
54
53
55
54
56
## Create an extension package
55
57
56
-
After writing your extension, you need to create a VSIX package to be able to install it in Azure Data Studio. You can use [vsce](https://github.com/Microsoft/vscode-vsce) to create the VSIX package.
58
+
After writing your extension, you need to create a VSIX package to be able to install it in Azure Data Studio. You can use [vsce](https://github.com/Microsoft/vscode-vsce)(Visual Studio Code Extensions) to create the VSIX package.
57
59
58
-
`npm install -g vsce`
60
+
```
61
+
npm install -g vsce
62
+
cd myExtensionName
63
+
vsce package
64
+
# The myExtensionName.vsix file has now been generated
65
+
```
59
66
60
-
`vsce package`
67
+
With a VSIX package, you can share your extension locally and privately by sharing the `.vsix` file and using the command **Extensions: Install From VSIX File** from the Command Palette to install the extension into Azure Data Studio.
61
68
62
69
63
70
## Publish an extension
@@ -71,5 +78,6 @@ To publish your new extension to Azure Data Studio:
71
78
72
79
Your extension will be reviewed and added to the extension gallery.
73
80
74
-
**Publishing Extension Updates**
75
-
The process to publish updates is similar to publishing the extension. Please make sure the version is updated in package.json
81
+
**Publishing extension updates**
82
+
83
+
The process to publish updates is similar to publishing the extension. Please make sure the version is updated in package.json.
Copy file name to clipboardExpand all lines: docs/azure-data-studio/extensions.md
+77-2Lines changed: 77 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -19,13 +19,14 @@ Extensions are provided by the Azure Data Studio team (Microsoft), as well as th
19
19
20
20
## Add Azure Data Studio extensions
21
21
22
-
1. Access the available extensions by selecting the Extensions Icon, or by selecting **Extensions** in the **View** menu.
22
+
1. Access the available extensions by selecting the Extensions Icon, or by selecting **Extensions** in the **View** menu. You can use the **View: Show Extensions** command, available in the **Command Palette** (F1 or `Ctrl+Shift+P`).
3. Select the extension you want and **Install** it.
@@ -35,6 +36,80 @@ Extensions are provided by the Azure Data Studio team (Microsoft), as well as th
35
36
If you're having problems accessing the Extensions Manager on Azure Data Studio, you can download the extension you need on our [GitHub Wiki](https://github.com/microsoft/azuredatastudio/wiki/List-of-Extensions).
36
37
37
38
38
-
## Access Installed Azure Data Studio Extensions
39
+
## Manage extensions
40
+
41
+
### List installed extensions
42
+
43
+
The default Extensions view shows the extensions that are currently enabled, all extensions that are recommended for you, and a collapsed container of all currently disabled extensions. The **Extensions: Show Installed Extensions** command, available in the **Command Palette** or the **More Actions**`(...)` drop-down menu, shows a list of all installed extensions, including disabled extensions.
44
+
45
+
### Uninstall an extension
46
+
47
+
To uninstall an extension, click the gear icon on the right of an extension entry and choose **Uninstall** from the drop-down menu. This uninstalls the selected extension and will prompt you to reload Azure Data Studio.
You may temporarily disable an extension instead of permanently removing an extension. You can either disable an extension across all Azure Data Studio sessions (**Disable**) or just for your current Workspace (**Disable (Workspace)**). You can also disable all of your currently installed extensions through the **Command Palette** with the commands **Extensions: Disable All Extensions** and **Extensions: Disable All Extensions (Workspace)**.
54
+
55
+
### Enable an extension
56
+
57
+
If an extension has been disabled, it will be in the **Disabled** section of the extension list and marked as ***Disabled***. You can re-enable it with the **Enable** or **Enable (Workspace)** commands in the drop-down menu. The **Command Palette** also lets you enable all extensions with the commands **Extensions: Enable All Extensions** and **Extensions: Enable All Extensions (Workspace)**.
Azure Data Studio automatically checks for and installs updates for any of your installed extensions. If you would like to turn off the auto-update feature, you can disable auto-update with the **Extensions: Disable Auto Updating Extensions** command.
64
+
65
+
To manually update an extension, you can check for extension updates with the **Extensions: Show Outdated Extensions** command which searches through your extension list using the `@outdated` filter. This will show any available updates for all currently installed extensions. Click the **Update** button on an outdated extension and the update will be installed. You will then be prompted to reload Azure Data Studio. You can also update all of your outdated extensions simultaneously with the **Extensions: Update All Extensions** command.
66
+
67
+
The **Extensions: Check for Extensions Updates** command is another way to check which of your extensions have updates available.
68
+
69
+
## Install from a VSIX
70
+
71
+
You can manually install an Azure Data Studio extension packaged in a `.vsix` file using the **Install from VSIX** command in the Extensions view command drop-down, or the **Extensions: Install from VSIX command** in the Command Palette and point to the extension's `.vsix` file.
72
+
73
+
## Access installed Azure Data Studio extensions
39
74
40
75
Each extension enhances your experience in Azure Data Studio in a different way. As a result, the entry point for extensions can vary. Refer to your installed extension's individual documentation for information on how its features can be accessed once it's installed.
76
+
77
+
## Extensions view filters
78
+
79
+
The Extensions view search box supports filters to help you find and manage extensions. The commands **Show Installed Extensions** and **Show Recommended Extensions** use filters such as `@installed` and `@recommended` in the search box.
80
+
81
+
You can see a complete listing of all filters and sort commands by typing @ in the extensions search box and navigating through the suggestions:
-`@builtin` - Show extensions that come with Azure Data Studio. Grouped by type (Programming Languages, Themes, etc.).
88
+
-`@disabled` - Show disabled installed extensions.
89
+
-`@enabled` - Show enabled installed extensions. Extensions can be individually enabled/disabled.
90
+
-`@installed` - Show installed extensions.
91
+
-`@outdated` - Show outdated installed extensions. A newer version is available on the Marketplace.
92
+
-`@recommended` - Show recommended extensions. Grouped as Workspace specific or general use.
93
+
-`@category` - Show extensions belonging to specified category. Below are a few of supported categories. For a complete list, type @category and follow the options in the suggestion list:
94
+
-`@category:themes`
95
+
-`@category:formatters`
96
+
-`@category:snippets`
97
+
These filters can be combined as well. For example, `@installed @category:themes` displays all installed themes.
98
+
99
+
If no filter is provided, the Extensions view displays currently installed and recommended extensions.
100
+
101
+
### Sorting
102
+
You can sort extensions with the `@sort` filter, which can take the following values:
103
+
104
+
-`installs` - Sort by extension gallery installation count, in descending order.
105
+
-`rating` - Sort by extension gallery rating (1-5 stars), in descending order.
106
+
-`name` - Sort alphabetically by extension name.
107
+
108
+
## Common questions
109
+
110
+
### Where are extensions installed?
111
+
Extensions are installed in a per user extensions folder. Depending on your platform, the location is in the following folder:
112
+
113
+
- Windows `%USERPROFILE%\.azuredatastudio\extensions`
| Fix bug #11356 Dark theme is now the default theme |[#11356](https://github.com/microsoft/azuredatastudio/issues/11356)|
28
+
| | |
29
+
30
+
### Known Issue
31
+
32
+
- Some users have reported connection errors from the new Microsoft.Data.SqlClient v2.0.0 included in this release. Users have found [following these instructions](https://github.com/microsoft/azuredatastudio/issues/11367#issuecomment-659614111) to successfully connect
33
+
34
+
## July 2020
35
+
36
+
July 15, 2020 / version: 1.20.0
37
+
38
+
39
+
40
+
| Change | Details |
41
+
| :----- | :------ |
42
+
| Added new Feature Tour | From welcome page and command palette, users can now launch a feature tour to get a walkthrough of commonly used features including Connections Viewlet, Notebooks viewlet, and Extensions Marketplace |
43
+
| New notebook features | • Header support in Markdown Toolbar<br/> • Side-by-side Markdown Preview in Text Cells
44
+
| Drag and Drop Columns and Tables in Query Editor | Users can now directly drag and drop columns and tables from connections viewlet to query editor |
45
+
| Azure Account icon added to Activity Bar) | More discoverable to sign in to Azure |
46
+
| Resolved bugs and issues | For a complete list of fixes see [Bugs and issues, on GitHub](https://github.com/microsoft/azuredatastudio/issues?q=is%3Aissue+milestone%3A%22July+2020+Release%22+is%3Aclosed). |
0 commit comments