Skip to content

Commit 3e079b2

Browse files
AUTO: Sync ScalarDL docs in English to docs site repo (#930)
1 parent 8c6dea3 commit 3e079b2

File tree

1 file changed

+17
-11
lines changed

1 file changed

+17
-11
lines changed

versioned_docs/version-3.9/how-to-run-applications.mdx

Lines changed: 17 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ You must disable Auditor since you'll be running your applications through only
2626

2727
:::note
2828

29-
If you are using the scalardl-samples environment, see the ledger.properties file for the corresponding storage.
29+
If you are using the `scalardl-samples` environment, see the `ledger.properties` file for the corresponding storage.
3030

3131
:::
3232

@@ -49,28 +49,34 @@ For details about the configurations, see the following:
4949
- [Client configurations](configurations.mdx#client-configurations)
5050
- [Ledger configurations](configurations.mdx#ledger-configurations)
5151

52-
### Decide which database to use
52+
### Configure your database
5353

54-
Ledger uses ScalarDB to interact with databases, which enables you to run ScalarDL on top of various databases. So, you need to decide on a database that ScalarDB supports based on your applications' requirements. For databases and their versions that ScalarDB supports, see [Requirements](requirements.mdx#databases).
54+
Ledger uses ScalarDB to interact with databases, which enables you to run ScalarDL on top of various databases. So, you need to decide on a database that ScalarDB supports based on your applications' requirements and configure several ScalarDB parameters.
5555

56-
You can configure a database as follows:
56+
For details about the ScalarDB parameters, see also [ScalarDB Configurations](https://scalardb.scalar-labs.com/docs/latest/configurations/).
57+
58+
#### Underlying database
59+
60+
You can configure which database to use as follows:
5761

5862
- In the Ledger configuration, set `scalar.db.storage`, `scalar.db.contact_points`, `scalar.db.username`, and `scalar.db.password` to the appropriate values based on the database that you'll be using.
5963

60-
For details about the above configurations, see [ScalarDB Configurations](https://scalardb.scalar-labs.com/docs/latest/configurations/).
64+
For databases and their versions that ScalarDB supports, see [Requirements](requirements.mdx#databases).
6165

62-
### Decide which isolation level to use
66+
:::warning
6367

64-
Ledger relies on the [Consensus Commit](https://scalardb.scalar-labs.com/docs/latest/consensus-commit/) transaction manager of ScalarDB to manage transactions. The transaction manager is responsible for guaranteeing the isolation property of transactions, which is crucial for ensuring the consistency and correctness of transactions.
68+
If your applications read and write a table through the Function feature, and the table is also directly accessed from ScalarDB applications, you need to properly configure the database chosen here. Specifically, both ScalarDL and ScalarDB applications must refer to the same Coordinator table to guarantee consistency.
69+
70+
:::
71+
72+
#### Isolation level
6573

66-
You can configure the isolation level of Ledger. If you are unsure about which isolation level to use, use `SERIALIZABLE`.
74+
Ledger relies on the [Consensus Commit](https://scalardb.scalar-labs.com/docs/latest/consensus-commit/) transaction manager of ScalarDB to manage transactions. The transaction manager is responsible for guaranteeing the isolation property of transactions, which is crucial for ensuring the consistency and correctness of transactions.
6775

76+
You can configure the isolation level of Ledger as follows. If you are unsure about which isolation level to use, use `SERIALIZABLE`.
6877

69-
You can configure the isolation level as follows:
7078
- In the Ledger configuration, set `scalar.db.consensus_commit.isolation_level` to an isolation level of your choice. The default value is `SNAPSHOT`.
7179

72-
For details about the above configurations, see [ScalarDB Configurations](https://scalardb.scalar-labs.com/docs/latest/configurations/).
73-
7480
### Decide which other configurations to use
7581

7682
You can also apply other configurations, such as TLS and gRPC configurations, for Ledger. For details about the configurations, see the following:

0 commit comments

Comments
 (0)