Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Cosmos DB name in supported DB docs #813

Merged
merged 2 commits into from
Feb 6, 2023
Merged

Conversation

kota2and3kan
Copy link
Contributor

This PR updates the Cosmos DB name from Cosmos DB to Cosmos DB for NoSQL in the supported DB document since the official name was changed.
https://learn.microsoft.com/en-us/azure/cosmos-db/nosql/
Please take a look!

Also, I want to discuss whether we should update this name in the documents other than the supported DB document.
There are some documents that state Cosmos DB. So, if we should update them to Cosmos DB for NoSQL, I will do it in this PR.
What do you think?

@brfrn169
Copy link
Collaborator

brfrn169 commented Feb 3, 2023

@kota2and3kan I think we can make the same change for all the documents in docs/ and README.md. And I don't think we need to do it in the source code for now.

@kota2and3kan
Copy link
Contributor Author

@brfrn169
Thank you for your comment!
I will update documents in docs/ and README.md in this PR.

@kota2and3kan kota2and3kan marked this pull request as draft February 3, 2023 01:35
## Cosmos DB setup
You also need to set up a Cosmos DB account to get started with ScalarDB on Cosmos DB.
## Cosmos DB for NoSQL setup
You also need to set up a Cosmos DB for NoSQL account to get started with ScalarDB on Cosmos DB for NoSQL.

This section explains how to set up [Azure Cosmos DB](https://docs.microsoft.com/en-us/azure/cosmos-db/introduction) with Azure portal.
1. Select **Azure Cosmos DB** service from the services on Azure portal.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I noticed that these steps are a bit different from the current steps.
I think it is better to add official document links to reduce the maintenance cost of this document.
So, I will update these steps in another PR.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I updated these steps in PR #814.

@@ -78,7 +78,7 @@ Create/Delete schemas in the storage defined in the config file
--ru=<ru> Base resource unit (supported in DynamoDB, Cosmos DB)
```

For Cosmos DB (Deprecated. Please use the command using a config file instead):
For Cosmos DB for NoSQL (Deprecated. Please use the command using a config file instead):
```console
Usage: java -jar scalardb-schema-loader-<version>.jar --cosmos [-D]
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't update this part since these descriptions are defined in the source code of Schema Loader.

@@ -146,7 +146,7 @@ admin.addNewColumnToTable("ns", "tbl", "c6", DataType.INT)

This should be executed with significant consideration as the execution time may vary greatly
depending on the underlying storage. Please plan accordingly especially if the database runs in production:
- For Cosmos and Dynamo DB: this operation is almost instantaneous as the table
- For Cosmos DB for NoSQL and DynamoDB: this operation is almost instantaneous as the table
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think Dynamo DB is just a typo. DynamoDB (no white space) is the correct name.

@@ -291,7 +291,7 @@ admin.addNewColumnToTable("ns", "tbl", "c6", DataType.INT)

This should be executed with significant consideration as the execution time may vary greatly
depending on the underlying storage. Please plan accordingly especially if the database runs in production:
- For Cosmos and Dynamo DB: this operation is almost instantaneous as the table
- For Cosmos DB for NoSQL and DynamoDB: this operation is almost instantaneous as the table
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think Dynamo DB is just a typo. DynamoDB (no white space) is the correct name.

@kota2and3kan kota2and3kan marked this pull request as ready for review February 3, 2023 06:54
@kota2and3kan
Copy link
Contributor Author

I updated the Cosmos DB name from Cosmos DB to Cosmos DB for NoSQL in all the documents.
Please take a look!

Copy link
Contributor

@komamitsu komamitsu left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thank you!

Copy link
Collaborator

@brfrn169 brfrn169 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM! Thank you!

Copy link
Contributor

@Torch3333 Torch3333 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM, thank you!

@brfrn169 brfrn169 merged commit d36b9c1 into master Feb 6, 2023
@brfrn169 brfrn169 deleted the update-cosmos-db-name branch February 6, 2023 11:39
@brfrn169 brfrn169 added this to Done in 3.9.0 Apr 27, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
No open projects
3.9.0
Done
Development

Successfully merging this pull request may close these issues.

None yet

4 participants