Skip to content

Commit

Permalink
AUTO: Sync ScalarDB docs in English to docs site repo
Browse files Browse the repository at this point in the history
  • Loading branch information
josh-wong committed Oct 15, 2024
1 parent c7a1743 commit d2b0c55
Show file tree
Hide file tree
Showing 18 changed files with 70 additions and 64 deletions.
6 changes: 3 additions & 3 deletions docs/api-guide.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -580,7 +580,7 @@ And if you need to check if a value of a column is null, you can use the `isNull
boolean isNull = result.isNull("<COLUMN_NAME>");
```

For more details, see the `Result` page in the [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.0/index.html) of the version of ScalarDB that you're using.
For more details, see the `Result` page in the [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.1/index.html) of the version of ScalarDB that you're using.

###### Execute `Get` by using a secondary index

Expand Down Expand Up @@ -787,7 +787,7 @@ For details about the `WHERE` clause, see [Use the `WHERE` clause](#use-the-wher

:::note

The `Put` operation is deprecated as of ScalarDB 3.13.0 and will be removed in a future release. Instead of using the `Put` operation, use the `Insert` operation, the `Upsert` operation, or the `Update` operation.
The `Put` operation is deprecated as of ScalarDB 3.13.1 and will be removed in a future release. Instead of using the `Put` operation, use the `Insert` operation, the `Upsert` operation, or the `Update` operation.

:::

Expand Down Expand Up @@ -1232,7 +1232,7 @@ For details about the `Scan` operation, see [`Scan` operation](#scan-operation).

:::note

The `Put` operation is deprecated as of ScalarDB 3.13.0 and will be removed in a future release. Instead of using the `Put` operation, use the `Insert` operation, the `Upsert` operation, or the `Update` operation.
The `Put` operation is deprecated as of ScalarDB 3.13.1 and will be removed in a future release. Instead of using the `Put` operation, use the `Insert` operation, the `Upsert` operation, or the `Update` operation.

:::

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -236,7 +236,7 @@ Select your build tool, and follow the instructions to add the build dependency

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb:3.13.0'
implementation 'com.scalar-labs:scalardb:3.13.1'
}
```
</TabItem>
Expand All @@ -247,7 +247,7 @@ Select your build tool, and follow the instructions to add the build dependency
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
```
</TabItem>
Expand All @@ -268,4 +268,4 @@ The following limitations apply to non-transactional storage operations:

### Learn more

- [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.0/index.html)
- [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.1/index.html)
6 changes: 6 additions & 0 deletions docs/scalardb-cluster/compatibility.mdx
Original file line number Diff line number Diff line change
@@ -1,3 +1,9 @@
---
tags:
- Enterprise Standard
- Enterprise Premium
---

# ScalarDB Cluster Compatibility Matrix

This document shows the compatibility of ScalarDB Cluster versions among client SDK versions.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ To add a dependency on the ScalarDB Cluster Java Client SDK by using Gradle, use

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```

Expand All @@ -27,7 +27,7 @@ To add a dependency by using Maven, use the following:
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-cluster-java-client-sdk</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
```

Expand Down Expand Up @@ -120,11 +120,11 @@ scalar.db.contact_points=direct-kubernetes:ns/scalardb-cluster

To load a schema via ScalarDB Cluster, you need to use the dedicated Schema Loader for ScalarDB Cluster (Schema Loader for Cluster).
Using the Schema Loader for Cluster is basically the same as using the [ScalarDB Schema Loader](../schema-loader.mdx) except the name of the JAR file is different.
You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0).
You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1).
After downloading the JAR file, you can run Schema Loader for Cluster with the following command:

```console
java -jar scalardb-cluster-schema-loader-3.13.0-all.jar --config <PATH_TO_CONFIG_FILE> -f <PATH_TO_SCHEMA_FILE> --coordinator
java -jar scalardb-cluster-schema-loader-3.13.1-all.jar --config <PATH_TO_CONFIG_FILE> -f <PATH_TO_SCHEMA_FILE> --coordinator
```

## ScalarDB Cluster SQL
Expand Down Expand Up @@ -164,8 +164,8 @@ To add the dependencies on the ScalarDB Cluster JDBC driver by using Gradle, use

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb-sql-jdbc:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-sql-jdbc:3.13.1'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```

Expand All @@ -176,12 +176,12 @@ To add the dependencies by using Maven, use the following:
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-sql-jdbc</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-cluster-java-client-sdk</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
</dependencies>
```
Expand All @@ -199,8 +199,8 @@ To add the dependencies by using Gradle, use the following:

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb-sql-spring-data:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-sql-spring-data:3.13.1'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```

Expand All @@ -211,12 +211,12 @@ To add the dependencies by using Maven, use the following:
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-sql-spring-data</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-cluster-java-client-sdk</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
</dependencies>
```
Expand Down Expand Up @@ -261,18 +261,18 @@ For details about how to configure Spring Data JDBC for ScalarDB, see [Configura

Like other SQL databases, ScalarDB SQL also provides a CLI tool where you can issue SQL statements interactively in a command-line shell.

You can download the SQL CLI for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0). After downloading the JAR file, you can run the SQL CLI with the following command:
You can download the SQL CLI for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1). After downloading the JAR file, you can run the SQL CLI with the following command:

```console
java -jar scalardb-cluster-sql-cli-3.13.0-all.jar --config <PATH_TO_CONFIG_FILE>
java -jar scalardb-cluster-sql-cli-3.13.1-all.jar --config <PATH_TO_CONFIG_FILE>
```

#### Usage

You can see the CLI usage with the `-h` option as follows:

```console
java -jar scalardb-cluster-sql-cli-3.13.0-all.jar -h
java -jar scalardb-cluster-sql-cli-3.13.1-all.jar -h
Usage: scalardb-sql-cli [-hs] -c=PROPERTIES_FILE [-e=COMMAND] [-f=FILE]
[-l=LOG_FILE] [-o=<outputFormat>] [-p=PASSWORD]
[-u=USERNAME]
Expand Down Expand Up @@ -303,6 +303,6 @@ For details about the ScalarDB Cluster gRPC API, refer to the following:

JavaDocs are also available:

* [ScalarDB Cluster Java Client SDK](https://javadoc.io/doc/com.scalar-labs/scalardb-cluster-java-client-sdk/3.13.0/index.html)
* [ScalarDB Cluster Common](https://javadoc.io/doc/com.scalar-labs/scalardb-cluster-common/3.13.0/index.html)
* [ScalarDB Cluster RPC](https://javadoc.io/doc/com.scalar-labs/scalardb-cluster-rpc/3.13.0/index.html)
* [ScalarDB Cluster Java Client SDK](https://javadoc.io/doc/com.scalar-labs/scalardb-cluster-java-client-sdk/3.13.1/index.html)
* [ScalarDB Cluster Common](https://javadoc.io/doc/com.scalar-labs/scalardb-cluster-common/3.13.1/index.html)
* [ScalarDB Cluster RPC](https://javadoc.io/doc/com.scalar-labs/scalardb-cluster-rpc/3.13.1/index.html)
Original file line number Diff line number Diff line change
Expand Up @@ -111,11 +111,11 @@ For details about the client modes, see [Developer Guide for ScalarDB Cluster wi

To load a schema via ScalarDB Cluster, you need to use the dedicated Schema Loader for ScalarDB Cluster (Schema Loader for Cluster).
Using the Schema Loader for Cluster is basically the same as using the [Schema Loader for ScalarDB](../schema-loader.mdx) except the name of the JAR file is different.
You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0).
You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1).
After downloading the JAR file, you can run the Schema Loader for Cluster with the following command:

```console
java -jar scalardb-cluster-schema-loader-3.13.0-all.jar --config database.properties -f schema.json --coordinator
java -jar scalardb-cluster-schema-loader-3.13.1-all.jar --config database.properties -f schema.json --coordinator
```

## Step 4. Run operations from GraphiQL
Expand Down Expand Up @@ -192,7 +192,7 @@ You should get the following result in the right pane:
### Mappings between GraphQL API and ScalarDB Java API

The automatically generated GraphQL schema defines queries, mutations, and object types for input/output to allow you to run CRUD operations for all the tables in the target namespaces.
These operations are designed to match the ScalarDB APIs defined in the [`DistributedTransaction`](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.0/com/scalar/db/api/DistributedTransaction.html) interface.
These operations are designed to match the ScalarDB APIs defined in the [`DistributedTransaction`](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.1/com/scalar/db/api/DistributedTransaction.html) interface.

Assuming you have an `account` table in a namespace, the following queries and mutations will be generated:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -87,10 +87,10 @@ For details about the client modes, see [Developer Guide for ScalarDB Cluster wi

## Step 3. Load a schema

To load a schema, you need to use [the SQL CLI](developer-guide-for-scalardb-cluster-with-java-api.mdx#sql-cli). You can download the SQL CLI from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0). After downloading the JAR file, you can use SQL CLI for Cluster by running the following command:
To load a schema, you need to use [the SQL CLI](developer-guide-for-scalardb-cluster-with-java-api.mdx#sql-cli). You can download the SQL CLI from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1). After downloading the JAR file, you can use SQL CLI for Cluster by running the following command:

```console
java -jar scalardb-cluster-sql-cli-3.13.0-all.jar --config scalardb-sql.properties --file schema.sql
java -jar scalardb-cluster-sql-cli-3.13.1-all.jar --config scalardb-sql.properties --file schema.sql
```

## Step 4. Load the initial data
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -87,10 +87,10 @@ For details about the client modes, see [Developer Guide for ScalarDB Cluster wi

## Step 3. Load a schema

To load a schema, you need to use [the SQL CLI](developer-guide-for-scalardb-cluster-with-java-api.mdx#sql-cli). You can download the SQL CLI from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0). After downloading the JAR file, you can use SQL CLI for Cluster by running the following command:
To load a schema, you need to use [the SQL CLI](developer-guide-for-scalardb-cluster-with-java-api.mdx#sql-cli). You can download the SQL CLI from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1). After downloading the JAR file, you can use SQL CLI for Cluster by running the following command:

```console
java -jar scalardb-cluster-sql-cli-3.13.0-all.jar --config scalardb-sql.properties --file schema.sql
java -jar scalardb-cluster-sql-cli-3.13.1-all.jar --config scalardb-sql.properties --file schema.sql
```

## Step 4. Modify `application.properties`
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -121,7 +121,7 @@ To use ScalarDB Cluster, open `build.gradle` in your preferred text editor. Then
dependencies {
...
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```

Expand Down Expand Up @@ -167,12 +167,12 @@ For details about the client modes, see [Developer Guide for ScalarDB Cluster wi

The database schema (the method in which the data will be organized) for the sample application has already been defined in [`schema.json`](https://github.com/scalar-labs/scalardb-samples/tree/main/scalardb-sample/schema.json).

To apply the schema, go to [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0) and download the ScalarDB Cluster Schema Loader to the `scalardb-samples/scalardb-sample` folder.
To apply the schema, go to [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1) and download the ScalarDB Cluster Schema Loader to the `scalardb-samples/scalardb-sample` folder.

Then, run the following command:

```console
java -jar scalardb-cluster-schema-loader-3.13.0-all.jar --config database.properties -f schema.json --coordinator
java -jar scalardb-cluster-schema-loader-3.13.1-all.jar --config database.properties -f schema.json --coordinator
```

#### Schema details
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,10 +72,10 @@ For details about the client modes, see [Developer Guide for ScalarDB Cluster wi

## Step 3. Load a schema

To load a schema via ScalarDB Cluster, you need to use the dedicated Schema Loader for ScalarDB Cluster (Schema Loader for Cluster). Using the Schema Loader for Cluster is basically the same as using the [Schema Loader for ScalarDB](../schema-loader.mdx) except the name of the JAR file is different. You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0). After downloading the JAR file, you can run the Schema Loader for Cluster with the following command:
To load a schema via ScalarDB Cluster, you need to use the dedicated Schema Loader for ScalarDB Cluster (Schema Loader for Cluster). Using the Schema Loader for Cluster is basically the same as using the [Schema Loader for ScalarDB](../schema-loader.mdx) except the name of the JAR file is different. You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1). After downloading the JAR file, you can run the Schema Loader for Cluster with the following command:

```console
java -jar scalardb-cluster-schema-loader-3.13.0-all.jar --config database.properties -f schema.json --coordinator
java -jar scalardb-cluster-schema-loader-3.13.1-all.jar --config database.properties -f schema.json --coordinator
```

## Step 4. Set up a Go environment
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -72,10 +72,10 @@ For details about the client modes, see [Developer Guide for ScalarDB Cluster wi

## Step 3. Load a schema

To load a schema via ScalarDB Cluster, you need to use the dedicated Schema Loader for ScalarDB Cluster (Schema Loader for Cluster). Using the Schema Loader for Cluster is basically the same as using the [Schema Loader for ScalarDB](../schema-loader.mdx) except the name of the JAR file is different. You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.0). After downloading the JAR file, you can run the Schema Loader for Cluster with the following command:
To load a schema via ScalarDB Cluster, you need to use the dedicated Schema Loader for ScalarDB Cluster (Schema Loader for Cluster). Using the Schema Loader for Cluster is basically the same as using the [Schema Loader for ScalarDB](../schema-loader.mdx) except the name of the JAR file is different. You can download the Schema Loader for Cluster from [ScalarDB Releases](https://github.com/scalar-labs/scalardb/releases/tag/v3.13.1). After downloading the JAR file, you can run the Schema Loader for Cluster with the following command:

```console
java -jar scalardb-cluster-schema-loader-3.13.0-all.jar --config database.properties -f schema.json --coordinator
java -jar scalardb-cluster-schema-loader-3.13.1-all.jar --config database.properties -f schema.json --coordinator
```

## Step 4. Set up a Python environment
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -270,7 +270,7 @@ Select your build tool, and follow the instructions to add the build dependency

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```
</TabItem>
Expand All @@ -281,7 +281,7 @@ Select your build tool, and follow the instructions to add the build dependency
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-cluster-java-client-sdk</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
```
</TabItem>
Expand All @@ -306,5 +306,5 @@ The following limitations apply to non-transactional storage operations:

### Learn more

- [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.0/index.html)
- [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb/3.13.1/index.html)
- [Developer Guide for ScalarDB Cluster with the Java API](developer-guide-for-scalardb-cluster-with-java-api.mdx)
Original file line number Diff line number Diff line change
Expand Up @@ -275,8 +275,8 @@ Also, for a list of supported DDLs, see [ScalarDB SQL Grammar](../scalardb-sql/g

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb-sql-jdbc:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-sql-jdbc:3.13.1'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```
</TabItem>
Expand All @@ -288,12 +288,12 @@ Also, for a list of supported DDLs, see [ScalarDB SQL Grammar](../scalardb-sql/g
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-sql-jdbc</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-cluster-java-client-sdk</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
</dependencies>
```
Expand Down Expand Up @@ -340,8 +340,8 @@ The following limitations apply to non-transactional storage operations:

```gradle
dependencies {
implementation 'com.scalar-labs:scalardb-sql:3.13.0'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.0'
implementation 'com.scalar-labs:scalardb-sql:3.13.1'
implementation 'com.scalar-labs:scalardb-cluster-java-client-sdk:3.13.1'
}
```
</TabItem>
Expand All @@ -353,12 +353,12 @@ The following limitations apply to non-transactional storage operations:
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-sql</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
<dependency>
<groupId>com.scalar-labs</groupId>
<artifactId>scalardb-cluster-java-client-sdk</artifactId>
<version>3.13.0</version>
<version>3.13.1</version>
</dependency>
</dependencies>
```
Expand Down Expand Up @@ -386,7 +386,7 @@ The following limitations apply to non-transactional storage operations:

<h3>Learn more</h3>

- [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb-sql/3.13.0/index.html)
- [Javadoc](https://javadoc.io/doc/com.scalar-labs/scalardb-sql/3.13.1/index.html)

</TabItem>
</Tabs>
Loading

0 comments on commit d2b0c55

Please sign in to comment.