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

use gcs:// instead of s3:// when the external storage is Google Cloud Storage #16893

Open
wants to merge 3 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion external-storage-uri.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ summary: Learn about the storage URI formats of external storage services, inclu

## URI Formats of External Storage Services

This document describes the URI formats of external storage services, including Amazon S3, GCS, and Azure Blob Storage.
This document describes the URI formats of external storage services, including Amazon S3, Google Cloud Storage (GCS), and Azure Blob Storage.

The basic format of the URI is as follows:

Expand Down Expand Up @@ -54,6 +54,10 @@ The following is an example of an Amazon S3 URI for [`IMPORT INTO`](/sql-stateme
s3://external/test.csv?access-key=${access-key}&secret-access-key=${secret-access-key}
```

> **Note:**
>
> Please note that the XML API of Google Cloud Storage (GCS) is not fully compatible with the s3:// protocol. If you are using GCS, please use the gcs:// protocol instead.
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
> Please note that the XML API of Google Cloud Storage (GCS) is not fully compatible with the s3:// protocol. If you are using GCS, please use the gcs:// protocol instead.
> Please note that the XML API of Google Cloud Storage (GCS) is not fully compatible with the `s3://` protocol. If you are using GCS, please use the `gcs://` protocol instead.


## GCS URI format

- `scheme`: `gcs` or `gs`
Expand Down
4 changes: 4 additions & 0 deletions ticdc/troubleshoot-ticdc.md
Original file line number Diff line number Diff line change
Expand Up @@ -145,3 +145,7 @@ This error is typically caused by the connection failure between TiCDC and the K
```shell
cdc cli changefeed create --server=http://127.0.0.1:8300 --sink-uri "kafka://127.0.0.1:9092/test?topic=test&protocol=open-protocol&kafka-version=2.4.0"
```

## The `[CDC:ErrS3StorageAPI]external storage api: NotImplemented` error is reported when I use TiCDC and enable Redo. What should I do?

This error might be caused by the external storage not fully supporting the `s3://` protocol. You can replace it with another protocol, such as `gs://`, if you are using Google Cloud Storage (GCS).
Loading