Manage a Data App

A Data App in Data Service (beta) is a group of endpoints that you can use to access data for a specific application. You can configure authorization settings using API keys to restrict access to endpoints in a Data App.

This document describes how to manage your Data Apps in the TiDB Cloud console. On the Data Service page, you can manage all Data Apps, endpoints, and API keys.

Create a Data App

To create a Data App for your project, perform the following steps:

1. On the Data Service page of your project, click Create DataApp in the left pane.

2. Enter a name for the Data App, and select clusters that you want the Data App to access.

3. (Optional) To automatically deploy endpoints of the Data App to your preferred GitHub repository and branch, enable Connect to GitHub, and then do the following:

   1. Click Install on GitHub, and then follow the on-screen instructions to install TiDB Cloud Data Service as an application on your target repository.

   2. Click Authorize to authorize access to the application on GitHub.

   3. Specify the target repository, branch, and directory where you want to save the configuration files of your Data App.

      Note

      • The directory must start with a slash (/). For example, /mydata. If the directory you specified does not exist in the target repository and branch, it will be created automatically.
      • The combination of repository, branch, and directory identifies the path of the configuration files, which must be unique among Data Apps. If your specified path is already used by another Data App, you need to specify a new path instead. Otherwise, the endpoints configured in the TiDB Cloud console for the current Data App will overwrite the files in your specified path.
      • If your specified path contains configuration files copied from another Data App and you want to import these files to the current Data App, see Import configurations of an existing Data App.

4. Click Create Data App.

   The newly created Data App is added to the top of the list. A default untitled endpoint is created for the new Data App.

5. If you have configured to connect your Data App to GitHub, check your specified GitHub directory. You will find that the Data App configuration files have been committed to the directory by tidb-cloud-data-service, which means that your Data App is connected to GitHub successfully.

   For your new Data App, Auto Sync & Deployment and Review Draft are enabled by default so you can easily synchronize Data App changes between TiDB Cloud console and GitHub and review changes before the deployment. For more information about the GitHub integration, see Deploy your Data App changes with GitHub automatically.

Modify a Data App

You can rename a Data App, and manage its API keys, linked clusters, and endpoints.

Rename a Data App

To rename a Data App, perform the following steps:

1. Navigate to the Data Service page of your project.
2. In the left pane, click the name of your target Data App to view its details.
3. In the Data App Properties area, click , modify the App Name field, and then click Confirm.

Manage GitHub connection

For more information, see Deploy automatically with GitHub.

Manage linked data sources

You can add or remove linked clusters for a Data App.

To link a cluster to a Data App, perform the following steps:

1. Navigate to the Data Service page of your project.
2. In the left pane, locate your target Data App and click the name of your target Data App to view its details.
3. In the Linked Data Sources area, click Add Cluster.
4. In the displayed dialog box, select a cluster from the list and click Add.

To remove a linked cluster from a Data App, perform the following steps:

1. Navigate to the Data Service page of your project.

2. In the left pane, locate your target Data App and click the name of your target Data App to view its details.

3. In the Linked Data Sources area, locate the target linked cluster you want to remove from the Data App, and click Delete in the Action column.

4. In the displayed dialog box, confirm the removal.

   After you remove a linked cluster, the cluster is not deleted, but the existing endpoints in the Data App cannot access it.

Manage an API key

For more information, see Manage an API key.

Manage an endpoint

For more information, see Manage an endpoint.

Manage deployments

To manage deployments, perform the following steps:

1. Navigate to the Data Service page of your project.

2. In the left pane, locate your target Data App and click the name of your target Data App to view its details.

3. Click the Deployments tab to view the deployment information.

4. In the upper-right corner, click Configure, and then choose your desired setting of Auto Sync & Deployment and Review Draft.

   • Auto Sync & Deployment

     • This option can be enabled only when your Data App is connected to GitHub. For more information, see Deploy automatically with GitHub.
     • When it is enabled, the changes made in your specified GitHub directory can be automatically deployed in TiDB Cloud, and the changes made in the TiDB Cloud console can be pushed to GitHub as well. You can find the corresponding deployment and commit information in the Data App deployment history.
     • When it is disabled, the changes made in your specified GitHub directory will NOT be deployed in TiDB Cloud, and the changes made in the TiDB Cloud console will NOT be pushed to GitHub either.

   • Review Draft

     • When it is enabled, you can review the Data App changes you made in the TiDB Cloud console before the deployment. Based on the review, you can either deploy or discard the changes.
     • When it is disabled, the Data App changes you made in the TiDB Cloud console are deployed directly.

5. In the Action column, you can edit or re-deploy your changes according to your needs.

Delete a Data App

To delete a Data App, perform the following steps:

1. Navigate to the Data Service page of your project.

2. In the left pane, locate your target Data App and click the name of your target Data App to view its details.

3. In the Delete Data App area, click Delete Data App. A dialog box for confirmation is displayed.

4. Type the name of target Data App, and then click I understand, delete.

   Once a Data App is deleted, the existing endpoints and API keys in the Data App are also deleted. If this Data App is connected to GitHub, deleting the App does not delete the files in the corresponding GitHub repository.