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
Copy file name to clipboardExpand all lines: CHANGELOG.md
+7Lines changed: 7 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -4,6 +4,13 @@ All notable changes to the "Liquibase" extension will be documented in this file
4
4
5
5
The format is based on [Keep a Changelog](http://keepachangelog.com/) and and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
6
6
7
+
## 1.2.0
8
+
9
+
### Changed
10
+
11
+
- Changed icon and name to better reflect that this extension does not rewrite Liquibase, but instead uses Liquibase CLI in version 4
[](https://sonarcloud.io/summary/new_code?id=aditosoftware_vscode-liquibase)
4
4
5
-
# Liquibase
5
+
# Liquibase 4 Integration for Visual Studio Code
6
6
7
7
A Visual Studio Code extension that supports executing [Liquibase commands](https://docs.liquibase.com/commands/command-list.html) without needing to use the command line.
8
+
It invokes the official Liquibase command-line tool to run commands; it does not reimplement Liquibase itself.
9
+
8
10
9
11
You can also create and edit [`liquibase.properties`](https://docs.liquibase.com/concepts/connections/creating-config-properties.html) files, which are used as a foundation for any command execution.
10
12
13
+
## Disclaimer
14
+
15
+
This extension integrates Liquibase with VS Code.
16
+
17
+
Liquibase® is a registered trademark of Liquibase, Inc.
18
+
19
+
This project is not affiliated with or endorsed by Liquibase, Inc.
20
+
21
+
Liquibase is licensed separately under the Functional Source License (FSL-1.1).
22
+
11
23
## Getting started
12
24
13
25
You can also get a brief overview of the extension with our **Walkthrough**.
@@ -32,7 +44,7 @@ All commands can be accessed from the "Liquibase" item in the status bar.
32
44
33
45

34
46
35
-
You can also access all commands by using the the command palette. It can be accessed with the keyboard shortcut <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>).
47
+
You can also access all commands by using the command palette. It can be accessed with the keyboard shortcut <kbd>Ctrl</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd> (macOS <kbd>Cmd</kbd> + <kbd>Shift</kbd> + <kbd>P</kbd>).
36
48
37
49
If you execute any command, you notice a general pattern of inputs. You will be always asked the following steps in this order:
38
50
@@ -41,11 +53,13 @@ If you execute any command, you notice a general pattern of inputs. You will be
41
53
3. Select the **contexts**. Some commands allow you to filter the changelogs by contexts. See ["Executing commands with and without contexts"](#executing-commands-with-and-without-contexts) for more details.
42
54
4. Any **additional options** you need to give before you can execute the command.
43
55
56
+
The extension passes the selected options to the Liquibase CLI and executes the corresponding command.
57
+
44
58
Some commands are accessible from the context menu. The context menu is available for all `xml`, `json`, `yaml`, `yml` and `sql` files, because those are the languages where you can write Liquibase changelogs. All commands are found in the _"Liquibase"_ sub menu. When executing a command from the context menu, it will use the current file as your changelog.
45
59
46
60
## Supported Liquibase Commands
47
61
48
-
Currently, the following Liquibase commands are supported:
62
+
Currently, the following Liquibase commands are supported via the Liquibase CLI:
49
63
50
64
> **Tip:** The link on the command itself will lead you to the Liquibase documentation. This will give you a better understanding of the technical details of each command.
51
65
>
@@ -87,7 +101,7 @@ If you want to control the storage location of the overview output, you can use
87
101
88
102
### Executing commands with and without contexts
89
103
90
-
Many liquibase commands can be executed with a context. After a connection and a changelog file was selected, you might be prompted with a context selection. There you have different options:
104
+
Many Liquibase commands can be executed with a context. After a connection and a changelog file was selected, you might be prompted with a context selection. There you have different options:
91
105
92
106
-**Use any of the recently loaded contexts**: This will give you **all contexts that were recently loaded** by "Load all contexts from the changelog file". You should use this option, if you want to use contexts and these have not changed from any recently loaded contexts. This option is only visible, if cached contexts are there.
93
107
-**Load all contexts from the changelog file**: This will **parse and read all changelog files** based on your root changelog file. Anytime you load new contexts, the old ones for this connection will be discarded. This option should be used, if you never have loaded your contexts before or your contexts have changed from any recently loaded context and you want to execute the query with contexts.
@@ -97,9 +111,9 @@ Both "Load all contexts from the changelog file" and "Use any of the recently lo
97
111
98
112
The recently loaded contexts are saved per database connection. That means, if you have three connections, then you have three sections of the contexts. For more information regarding caching, see [the caching section](#caching).
99
113
100
-
## Converting changelogs from one liquibase format to another format
114
+
## Converting changelogs from one Liquibase format to another format
101
115
102
-
With the two commands `Liquibase: Converts a file from one liquibase format to another` and `Liquibase: Converts a folder from one liquibase format to another`, you can convert changelogs from one format to another.
116
+
With the two commands `Liquibase: Converts a file from one Liquibase format to another` and `Liquibase: Converts a folder from one Liquibase format to another`, you can convert changelogs from one format to another.
103
117
104
118
> **NOTE:** It is very important, that you check to produced results by the command. We do not guarantee the completeness and correctness of the files.
105
119
@@ -122,6 +136,6 @@ You can remove any values from the cache with the `Liquibase: Cache: Remove any
122
136
123
137
## View logs
124
138
125
-
This extension write to the output. It can be viewed by executing the command `Output: Focus on Output View` and then selecting the channel _"Liquibase"_.
139
+
This extension writes to the output. It can be viewed by executing the command `Output: Focus on Output View` and then selecting the channel _"Liquibase"_.
126
140
127
-
Logs will be also written to a log folder on your OS. You can reach the log folder by executing the command `Developer: Open Extension Logs Folder` and then navigating to the liquibase folder.
141
+
Logs will be also written to a log folder on your OS. You can reach the log folder by executing the command `Developer: Open Extension Logs Folder` and then navigating to the folder containing the log files.
0 commit comments