skript-db/README.md

81 lines
2.5 KiB
Markdown
Raw Normal View History

2019-06-22 19:11:29 +00:00
# skript-db
> Sensible SQL support for Skript.
---
2021-01-18 12:59:08 +00:00
### Difference from original skript-db
- Fixed local variables disappearance in newer Skript versions (very hacky fix, but it works, so that's good!)
2021-02-12 10:44:58 +00:00
- Thread-pool size is now automatically increasing on demand to use of CachedThreadPool, instead of a fixed hard-coded number
2021-01-18 12:59:08 +00:00
- Uses a newer version of HikariCP
- Only meant to be used by newer Minecraft versions (1.8 is not supported)
2021-05-12 10:17:58 +00:00
- Replaced `synchronously execute` with `quickly execute`, which allows to speed up queries by 50ms with some risk
2021-01-18 12:59:08 +00:00
2020-05-02 17:25:36 +00:00
### Expression `Data Source` => `datasource`
Stores the connection information for a data source. This should be saved to a variable in a
`script load` event or manually through an effect command.
The url format for your database may vary! The example provided uses a MySQL database.
#### Syntax
```
[the] data(base|[ ]source) [(of|at)] %string%
```
#### Examples
```
set {sql} to the database "mysql://localhost:3306/mydatabase?user=admin&password=12345&useSSL=false"
```
---
2017-11-19 03:49:49 +00:00
### Effect `Execute Statement`
Executes a statement on a database and optionally stores the result in a variable. Expressions
embedded in the query will be escaped to avoid SQL injection.
2020-05-02 17:25:36 +00:00
If a single variable, such as `{test}`, is passed, the variable will be set to the number of
affected rows.
2020-05-02 17:25:36 +00:00
If a list variable, such as `{test::*}`, is passed, the query result will be mapped to the list
variable in the form `{test::<column name>::<row number>}`
2021-05-12 10:17:58 +00:00
If `quickly` is specified, the SQL query will be done without jumping back to main thread, which speeds it up by 50ms, however that makes code after it to also be on separate thread, you can jump back to main thread by adding `wait a tick`
2017-11-19 03:49:49 +00:00
#### Syntax
```
[quickly] execute %string% (in|on) %datasource% [and store [[the] (output|result)[s]] (to|in) [the] [var[iable]] %-objects%]
```
2017-11-19 03:49:49 +00:00
#### Examples
2017-11-19 03:49:49 +00:00
```
execute "select * from table" in {sql} and store the result in {output::*}
```
```
2020-05-02 17:25:36 +00:00
execute "select * from %{table variable}%" in {sql} and store the result in {output::*}
2017-11-19 03:49:49 +00:00
```
2017-11-19 03:52:52 +00:00
---
### Expression `Last Data Source Error` => `text`
Stores the error from the last executed statement, if there was one.
2017-11-19 03:49:49 +00:00
#### Syntax
```
[the] [last] (sql|db|data(base|[ ]source)) error
2017-11-19 03:49:49 +00:00
```
2017-11-19 03:52:52 +00:00
---
### Expression `Unsafe Expression` => `text`
Opts out of automatic SQL injection protection for a specific expression in a statement.
2017-11-19 03:49:49 +00:00
#### Syntax
```
unsafe %text%
```
2017-11-19 03:49:49 +00:00
#### Examples
```
execute "select %unsafe {columns variable}% from %{table variable}%" in {sql}
```
```
execute unsafe {fully dynamic query} in {sql}
```
2017-11-19 03:52:52 +00:00
---