+
+#### Result
+
+A Prisma schema is now linked to your project.
+
+The platform updates the Prisma schema in your project every time you push a schema change to your repository.
+
+#### Upload a schema file
+
+Steps:
+
+1. On the **Or upload your schema** section, either:
+ - Click on the _drop zone_ to open your file manager and select your schema
+ - Drag and drop your schema file to the _drop zone_
+2. Review the preview of your schema file
+
+ +**Note**
- For more information, see [Static egress IP address](/data-platform/static-ips). +For more information, see [Static egress IP address](/data-platform/static-ips).
+**Note**
- Select a Data Proxy location that is close to the geographic location of the database for the new environment.
- If you select a location that is geographically distant from the database, then when your application sends requests to the database through the Data Proxy, you might notice some delay in the responses. +Select a Data Proxy location that is close to the geographic location of the database for the new environment.
+If you select a location that is geographically distant from the database, then when your application sends requests to the database through the Data Proxy, you might notice some delay in the responses.
+**Important**
- After you create an environment, you cannot change its Data Proxy location. You can select a different Data Proxy location only when you create a new environment. +After you create an environment, you cannot change its Data Proxy location. You can select a different Data Proxy location only when you create a new environment.
+{' '}
+
2. In **Environment name**, enter a name for the environment.
- Use any naming convention that makes sense for your project.
- If applicable, you can use the Staging, Development, or <Feature name> conventions to dedicate an environment to a database development workflow or the development of a specific feature. +**Note**
+Use any naming convention that makes sense for your project.
+If applicable, you can use the Staging, Development, or <Feature name> conventions to dedicate an environment to a database development workflow or the development of a specific feature.
+**Note**
- For more information, see [Static egress IP address](/data-platform/static-ips). +For more information, see [Static egress IP address](/data-platform/static-ips).
+**Note**
- Select a Data Proxy location that is close to the geographic location of the database for the new environment.
- If you select a location that is geographically distant from the database, then when your application sends requests to the database through the Data Proxy, you might notice some delay in the responses. +Select a Data Proxy location that is close to the geographic location of the database for the new environment.
+If you select a location that is geographically distant from the database, then when your application sends requests to the database through the Data Proxy, you might notice some delay in the responses.
+**Important**
- After you create an environment, you cannot change its Data Proxy location. You can select a different Data Proxy location only when you create a new environment. +After you create an environment, you cannot change its Data Proxy location. You can select a different Data Proxy location only when you create a new environment.
+
### Result
@@ -228,6 +229,43 @@ The platform introspects the database to read the data models so that it can gen
Your browser is redirected to **Data Browser** for the new environment.
+#### If introspection fails and can't generate a schema
+
+You will be prompted with an error notification that introspection failed. This means the environment was not created. The error prompt will contain an **Upload a schema** button that will allow you to complete environment creation by [uploading a schema](#upload-a-schema-file).
+
+##### Upload a schema file
+
+Steps:
+
+1. On the notification, click **Upload a schema file**
+
+ 
+
+2. On the **Upload a schema file** section, either
+ - Click on the _drop zone_ to open your file manager and select your schema
+ - Drag and drop your schema file to the _drop zone_
+3. Review the preview of your schema file
+
+ + + The schema preview does not contain any syntax highlighting for your schema file. + +
+ +
+
### What's next
You can switch between the environments of a project from the **Environments** drop-down menu in the upper left (next to the **Projects** drop-down).
@@ -239,4 +277,4 @@ You can switch between the environments of a project from the **Environments** d
/>
- After you switch to a different environment, **Data Browser** and **Query Console** use the database and Data Proxy location configured for that environment.
-- What **Schema Viewer** shows differs depending on whether your database is empty or contains some models. For more information, see [Manage schema updates with Schema Viewer](/data-platform/schema-viewer).
\ No newline at end of file
+- What **Schema Viewer** shows differs depending on whether your database is empty or contains some models. For more information, see [Manage schema updates with Schema Viewer](/data-platform/schema-viewer).
diff --git a/content/800-data-platform/700-schema-viewer.mdx b/content/800-data-platform/700-schema-viewer.mdx
index bd3486084d..48e13d3065 100644
--- a/content/800-data-platform/700-schema-viewer.mdx
+++ b/content/800-data-platform/700-schema-viewer.mdx
@@ -63,9 +63,34 @@ You can use the **Refresh Schema** option only if you are the [Project owner](/d
alt="Schema Viewer - Projects with introspected Prisma schema"
/>
+### Upload a schema file
+
+If the schema refresh fails, an error notification pops up at the top of the page with the option to upload a schema file.
+
+Click the **upload a schema** link in the notification. Below the **Provide a schema** section, a new **Upload a Prisma schema file** section is enabled. You can either:
+
+- Click on the _drop zone_ to open your file manager and select your schema
+- Drag and drop your schema file to the _drop zone_
+
+Review the contents of the schema file in the _drop zone_ and once you are done, click **Upload file**
+
++ +The schema preview does not contain any syntax highlighting for your schema file. + +
+
## Projects without a schema
-If you create your project with an empty database (one which contains no models) and do not enable schema synchronization, the platform tries to introspect the database but because that contains no models, the platform cannot generate a Prisma schema for it.
+If introspection fails during project creation and you chose to skip providing a schema, your project exist without an associated schema.
For such projects, **Schema Viewer** does not show a schema and provides the option to link a Prisma schema from a GitHub repository or to manually trigger a new introspection.
@@ -75,7 +100,7 @@ For such projects, **Schema Viewer** does not show a schema and provides the opt
alt="Schema Viewer - Projects with no models and no Prisma schema"
/>
-For such projects, [**Data Browser**](/data-platform/data-browser) and [**Query Console**](/data-platform/query-console) remain inactive until you enable schema synchronization or manually trigger a new introspection.
+The [**Data Browser**](/data-platform/data-browser) and [**Query Console**](/data-platform/query-console) remain disabled until you enable schema synchronization or manually re-trigger a new introspection.
## Enable schema synchronization
diff --git a/content/800-data-platform/images/environments/create-env-upload-schema-file.png b/content/800-data-platform/images/environments/create-env-upload-schema-file.png
new file mode 100644
index 0000000000..27e814109a
Binary files /dev/null and b/content/800-data-platform/images/environments/create-env-upload-schema-file.png differ
diff --git a/content/800-data-platform/images/projects/create-02-link-schema-file-from-a-repository.png b/content/800-data-platform/images/projects/create-02-link-schema-file-from-a-repository.png
new file mode 100644
index 0000000000..dc4bc00f8f
Binary files /dev/null and b/content/800-data-platform/images/projects/create-02-link-schema-file-from-a-repository.png differ
diff --git a/content/800-data-platform/images/projects/create-02-upload-schema-file.png b/content/800-data-platform/images/projects/create-02-upload-schema-file.png
new file mode 100644
index 0000000000..842466f163
Binary files /dev/null and b/content/800-data-platform/images/projects/create-02-upload-schema-file.png differ
diff --git a/content/800-data-platform/images/schema-viewer/project-schema-viewer.png b/content/800-data-platform/images/schema-viewer/project-schema-viewer.png
new file mode 100644
index 0000000000..bdec4d7cf3
Binary files /dev/null and b/content/800-data-platform/images/schema-viewer/project-schema-viewer.png differ