You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: markdown-pages/en/tidbcloud/master/tidb-cloud/configure-external-storage-access.md
+47-15Lines changed: 47 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,7 +22,7 @@ If you need to configure these external storages for a TiDB Cloud Dedicated clus
22
22
23
23
## Configure Amazon S3 access
24
24
25
-
To allow a TiDB Cloud <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> to access the source data in your Amazon S3 bucket, configure the bucket access for the <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> using either of the following methods:
25
+
To allow a TiDB Cloud <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> to access your Amazon S3 bucket, configure the bucket access for the <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> using either of the following methods:
26
26
27
27
-[Use a Role ARN](#configure-amazon-s3-access-using-a-role-arn): use a Role ARN to access your Amazon S3 bucket.
28
28
-[Use an AWS access key](#configure-amazon-s3-access-using-an-aws-access-key): use the access key of an IAM user to access your Amazon S3 bucket.
@@ -35,11 +35,11 @@ It is recommended that you use [AWS CloudFormation](https://docs.aws.amazon.com/
35
35
>
36
36
> Role ARN access to Amazon S3 is only supported for <CustomContentplan="starter,essential">clusters</CustomContent><CustomContentplan="premium">instances</CustomContent> with AWS as the cloud provider. If you use a different cloud provider, use an AWS access key instead. For more information, see [Configure Amazon S3 access using an AWS access key](#configure-amazon-s3-access-using-an-aws-access-key).
37
37
38
-
1. Open the **Import** page for your target <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent>.
38
+
1. Open the **Import**or **Export**page for your target <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent>.
39
39
40
40
1. Log in to the [TiDB Cloud console](https://tidbcloud.com/) and <CustomContentplan="starter,essential">navigate to the [**Clusters**](https://tidbcloud.com/project/clusters) page of your project.</CustomContent><CustomContentplan="premium">navigate to the [**TiDB Instances**](https://tidbcloud.com/tidbs) page.</CustomContent>
41
41
42
-
2. Click the name of your target <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> to go to its overview page, and then click **Data** > **Import** in the left navigation pane.
42
+
2. Click the name of your target <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> to go to its overview page, and then click **Data** > **Import**or **Data** > **Export**in the left navigation pane.
43
43
44
44
2. Open the **Add New ARN** dialog.
45
45
@@ -51,10 +51,23 @@ It is recommended that you use [AWS CloudFormation](https://docs.aws.amazon.com/
51
51
52
52
- If you want to export data to Amazon S3, open the **Add New ARN** dialog as follows:
53
53
54
-
1. Click **Export data to...** > **Amazon S3**. If your <CustomContentplan="starter,essential">cluster</CustomContent><CustomContentplan="premium">instance</CustomContent> has neither imported nor exported any data before, click **Click here to export data to...** > **Amazon S3** at the bottom of the page.
54
+
<CustomContentplan="starter,essential">
55
+
56
+
1. Click **Export data to...** > **Amazon S3**. If your cluster has neither imported nor exported any data before, click **Click here to export data to...** > **Amazon S3** at the bottom of the page.
55
57
2. Fill in the **Folder URI** field.
56
58
3. Choose **AWS Role ARN** and click **Click here to create new one with AWS CloudFormation**.
57
59
60
+
</CustomContent>
61
+
62
+
<CustomContentplan="premium">
63
+
64
+
1. Click **Export Data**.
65
+
2. Choose **Amazon S3** in **Target Connection**.
66
+
3. Fill in the **Folder URI** field.
67
+
4. Choose **AWS Role ARN** and click **Click here to create new one with AWS CloudFormation**.
68
+
69
+
</CustomContent>
70
+
58
71
3. Create a role ARN with an AWS CloudFormation template.
59
72
60
73
1. In the **Add New ARN** dialog, click **AWS Console with CloudFormation Template**.
@@ -80,7 +93,7 @@ If you have any trouble creating a role ARN with AWS CloudFormation, you can tak
80
93
81
94
1. Sign in to the [AWS Management Console](https://console.aws.amazon.com/) and open the [Amazon S3 console](https://console.aws.amazon.com/s3/).
82
95
83
-
2. In the **Buckets** list, choose the name of your bucket with the source data, and then click **Copy ARN** to get your S3 bucket ARN (for example, `arn:aws:s3:::tidb-cloud-source-data`). Take a note of the bucket ARN for later use.
96
+
2. In the **Buckets** list, choose the name of your target bucket, and then click **Copy ARN** to get your S3 bucket ARN (for example, `arn:aws:s3:::tidb-cloud-source-data`). Take a note of the bucket ARN for later use.
@@ -107,7 +120,7 @@ If you have any trouble creating a role ARN with AWS CloudFormation, you can tak
107
120
"s3:GetObjectVersion",
108
121
"s3:PutObject"
109
122
],
110
-
"Resource": "<Your S3 bucket ARN>/<Directory of your source data>/*"
123
+
"Resource": "<Your S3 bucket ARN>/<Your data directory>/*"
111
124
},
112
125
{
113
126
"Sid": "VisualEditor1",
@@ -123,10 +136,10 @@ If you have any trouble creating a role ARN with AWS CloudFormation, you can tak
123
136
124
137
In the policy text field, replace the following configurations with your own values.
125
138
126
-
- `"Resource": "<Your S3 bucket ARN>/<Directory of the source data>/*"`. For example:
139
+
- `"Resource": "<Your S3 bucket ARN>/<Your data directory>/*"`, where `<Your data directory>` is the target directory for exported data or the source directory for imported data. For example:
127
140
128
-
- If your source data is stored in the root directory of the `tidb-cloud-source-data` bucket, use `"Resource": "arn:aws:s3:::tidb-cloud-source-data/*"`.
129
-
- If your source data is stored in the `mydata` directory of the bucket, use `"Resource": "arn:aws:s3:::tidb-cloud-source-data/mydata/*"`.
141
+
- If your data for import or export is in the root directory of the `tidb-cloud-source-data` bucket, use `"Resource": "arn:aws:s3:::tidb-cloud-source-data/*"`.
142
+
- If your data for import or export is in the `mydata` directory of the bucket, use `"Resource": "arn:aws:s3:::tidb-cloud-source-data/mydata/*"`.
130
143
131
144
Make sure that `/*` is added to the end of the directory so TiDB Cloud can access all files in this directory.
132
145
@@ -221,7 +234,7 @@ Take the following steps to configure a service account key:
221
234
222
235
</CustomContent>
223
236
224
-
<CustomContent plan="starter,essential">
237
+
<CustomContent plan="starter,essential,premium">
225
238
226
239
## Configure Azure Blob Storage access
227
240
@@ -231,17 +244,36 @@ You can create a SAS token either using an [Azure ARM template](https://learn.mi
231
244
232
245
To create a SAS token using an Azure ARM template, take the following steps:
233
246
234
-
1. Open the **Import** page for your target cluster.
247
+
1. Open the **Import** or **Export** page for your target <CustomContent plan="starter,essential">cluster</CustomContent><CustomContent plan="premium">instance</CustomContent>.
235
248
236
-
1. Log in to the [TiDB Cloud console](https://tidbcloud.com/) and navigate to the [**Clusters**](https://tidbcloud.com/project/clusters) page of your project.
249
+
1. Log in to the [TiDB Cloud console](https://tidbcloud.com/) and <CustomContent plan="starter,essential">navigate to the [**Clusters**](https://tidbcloud.com/project/clusters) page of your project.</CustomContent><CustomContent plan="premium">navigate to the [**TiDB Instances**](https://tidbcloud.com/tidbs) page.</CustomContent>
237
250
238
-
2. Click the name of your target clusterto go to its overview page, and then click **Data** > **Import** in the left navigation pane.
251
+
2. Click the name of your target <CustomContent plan="starter,essential">cluster</CustomContent><CustomContent plan="premium">instance</CustomContent> to go to its overview page, and then click **Data** > **Import** or **Data** > **Export** in the left navigation pane.
239
252
240
253
2. Open the **Generate New SAS Token via ARM Template Deployment** dialog.
241
254
242
-
1. Click **Export data to...** > **Azure Blob Storage**. If your cluster has neither imported nor exported any data before, click **Click here to export data to...** > **Azure Blob Storage** at the bottom of the page.
255
+
- If you want to import data from Azure Blob Storage:
256
+
257
+
1. Click **Import from Azure Blob Storage**.
258
+
2. Fill in the **Folder URI** field.
259
+
3. In the **SAS Token** field, click **Click here to create a new one with Azure ARM template**.
260
+
261
+
- If you want to export data to Azure Blob Storage:
262
+
263
+
<CustomContent plan="starter,essential">
264
+
265
+
1. Click **Export data to...** > **Azure Blob Storage**. If your cluster has neither imported nor exported any data before, click **Click here to export data to...** > **Azure Blob Storage** at the bottom of the page.
266
+
2. Scroll down to the **Azure Blob Storage Settings** area, and then click **Click here to create a new one with Azure ARM template** under the SAS Token field.
267
+
268
+
</CustomContent>
269
+
270
+
<CustomContent plan="premium">
271
+
272
+
1. Click **Export Data**.
273
+
2. Choose **Azure Blob Storage** in **Target Connection**.
274
+
3. Click **Click here to create a new one with Azure ARM template** under the SAS Token field.
243
275
244
-
2. Scroll down to the **Azure Blob Storage Settings** area, and then click **Click here to create a new one with Azure ARM template** under the SAS Token field.
276
+
</CustomContent>
245
277
246
278
3. Create a SAS token with the Azure ARM template.
0 commit comments