Skip to content

Commit a218198

Browse files
clarify export data
1 parent d61dbd6 commit a218198

File tree

11 files changed

+24
-132
lines changed

11 files changed

+24
-132
lines changed

content/deploy/admin/dgraph-administration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -145,7 +145,7 @@ As an `Administrator` you might want to export data from Dgraph to:
145145
* move the data from Dgraph Cloud instance to another Dgraph instance, or Dgraph Cloud instance
146146
* share your data
147147

148-
For more information about exporting your database, see [Export data]({{< relref "howto/exportdata/about-export.md" >}})
148+
For more information about exporting your database, see [Export data]({{< relref "export-data.md" >}})
149149

150150
## Shut down database
151151

content/deploy/installation/production-checklist.md

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -39,8 +39,9 @@ Do not run multiple Dgraph Zeros or Dgraph Alpha processes on a single machine.
3939

4040
### Operating System
4141

42-
Dgraph is designed to run on Linux. To run Dgraph on Windows
43-
and macOS, use the [standalone Docker image]({{<relref "dgraph-overview#to-run-dgraph-using-the-standalone-docker-image">}}).
42+
Dgraph is designed to run on Linux.
43+
44+
To run Dgraph on Windows and macOS, use the [standalone Docker image]({{<relref identifier="learning-environment">}}).
4445

4546
### CPU and Memory
4647

@@ -104,7 +105,7 @@ A Dgraph instance is run as a single process from a single static binary. It doe
104105

105106
A backup policy is a predefined, set schedule used to schedule backups of information from business applications. A backup policy helps to ensure data recoverability in the event of accidental data deletion, data corruption, or a system outage.
106107

107-
For Dgraph, backups are created using the [backups enterprise feature]({{< relref "/enterprise-features/binary-backups" >}}). You can also create full exports of your data and schema using [data exports]({{< relref "dgraph-administration.md#exporting-database" >}}) available as an open source feature.
108+
For Dgraph, backups are created using the [backups feature]({{< relref "/enterprise-features/binary-backups" >}}). You can also create full exports of your data and schema using [data exports]({{< relref "dgraph-administration.md#exporting-database" >}}).
108109

109110
We **strongly** recommend that you have a backup policy in place before moving your application to the production phase, and we also suggest that you have a backup policy even for pre-production apps supported by Dgraph database instances running in development, staging, QA or pre-production clusters.
110111

content/dql/query/dql-query.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -190,7 +190,7 @@ Dgraph offers functions for
190190
- if geo area intersects a given are : [intersects]({{< relref "functions.md#intersects" >}})
191191

192192

193-
### Variable (`var`) block
193+
### Var block
194194

195195
Variable blocks (`var` blocks) start with the keyword `var` instead of a block name.
196196

content/dql/query/functions.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ Functions allow filtering based on properties of nodes or [variables]({{<relref
1111

1212

1313
Comparison functions (`eq`, `ge`, `gt`, `le`, `lt`) in the query root (aka `func:`) can only
14-
be applied on [indexed predicates]({{< relref "dql-schema.md#indexing" >}}).
14+
be applied on [indexed predicates]({{< relref "predicate-indexing.md" >}}).
1515
Comparison functions can be used on [@filter]({{<relref "filter.md" >}}) directives even on predicates that have not been indexed.
1616
Filtering on non-indexed predicates can be slow for large datasets, as they require
1717
iterating over all of the possible values at the level where the filter is being used.
@@ -377,7 +377,7 @@ Query Example: Movies with directors with `Steven` in `name` and have directed m
377377

378378

379379

380-
Query Example: A movie in each genre that has over 30000 movies. Because there is no order specified on genres, the order will be by UID. The [count index]({{< relref "dql-schema.md#count-index">}}) records the number of edges out of nodes and makes such queries more .
380+
Query Example: A movie in each genre that has over 30000 movies. Because there is no order specified on genres, the order will be by UID. The [count index]({{< relref "predicate-indexing.md#count-index">}}) records the number of edges out of nodes and makes such queries more .
381381

382382
{{< runnable >}}
383383
{

content/dql/query/sorting.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,7 +19,7 @@ Sortable Types: `int`, `float`, `String`, `dateTime`, `default`
1919

2020
Results can be sorted in ascending order (`orderasc`) or descending order (`orderdesc`) by a predicate or variable.
2121

22-
For sorting on predicates with [sortable indices]({{< relref "dql-schema.md#sortable-indices">}}), Dgraph sorts on the values and with the index in parallel and returns whichever result is computed first.
22+
For sorting on predicates with [sortable indices]({{< relref "predicate-indexing.md#sortable-indices">}}), Dgraph sorts on the values and with the index in parallel and returns whichever result is computed first.
2323

2424
{{% notice "note" %}}
2525
Dgraph returns `null` values at the end of the results, irrespective of their sort. This behavior is consistent across indexed and non-indexed sorts.

content/howto/exportdata/export-data.md renamed to content/howto/export-data.md

Lines changed: 13 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,20 @@
11
+++
2-
title = "Export data from Dgraph"
2+
title = "Export data"
33
type = "docs"
44
keywords = "export, data, self hosted"
5+
weight = 3
56
[menu.main]
6-
parent = "exportdata"
7-
weight = 3
7+
identifier = "exportdata"
8+
parent = "howto"
89
+++
910

10-
As an `Administrator` you can export data on all nodes, configure the Alpha server, specify the export format, export to an object store, disable HTTPS for exports, and encrypt exports
11+
As an `Administrator` you can export data from Dgraph to an an object store, NFS, or a file path.
12+
13+
When you export data, three files are generated:
14+
15+
* `g01.gql_schema.gz`: The GraphQL schema file. This file can be imported using the Schema APIs
16+
* `g01.json.gz` or `g01.rdf.gz`: the data from your instance in JSON format or RDF format. By default, Dgraph exports data in RDF format.
17+
* `g01.schema.gz`: This file is the internal Dgraph schema. If you have set up the Dgraph Cloud instance with a GraphQL schema, then you can ignore this file.
1118

1219
## Export data using the GraphQL admin endpoint
1320

@@ -171,7 +178,7 @@ You can access Azure Blob Storage locally using one of these methods:
171178
--set accessKey="<AccountName>",secretKey="<AccountKey>" \
172179
--set azuregateway.enabled=true
173180
```
174-
You can use the [MinIO GraphQL mutation]({{< relref "/howto/exportdata/export-data.md#example-mutation-to-export-to-minio" >}}) with MinIO configured as a gateway.
181+
You can use the [MinIO GraphQL mutation]({{< relref "export-data.md#example-mutation-to-export-to-minio" >}}) with MinIO configured as a gateway.
175182

176183
### Google Cloud Storage
177184

@@ -219,7 +226,7 @@ When you have a `credentials.json`, you can access GCS locally using one of thes
219226
helm install my-gateway minio/minio \
220227
--values myvalues.yaml
221228
```
222-
You can use the [MinIO GraphQL mutation]({{< relref "/howto/exportdata/export-data.md#example-mutation-to-export-to-minio" >}}) with MinIO configured as a gateway.
229+
You can use the [MinIO GraphQL mutation]({{< relref "export-data.md#example-mutation-to-export-to-minio" >}}) with MinIO configured as a gateway.
223230
224231
## Disable HTTPS for exports to S3 and Minio
225232

content/howto/exportdata/_index.md

Lines changed: 0 additions & 8 deletions
This file was deleted.

content/howto/exportdata/about-export.md

Lines changed: 0 additions & 18 deletions
This file was deleted.

content/howto/exportdata/export-data-cloud.md

Lines changed: 0 additions & 90 deletions
This file was deleted.

content/howto/importdata/live-loader.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -18,7 +18,7 @@ Verify that you have a local folder `<local-path-to-data>` containing
1818
- at least one **data file** in RDF or JSON in plain or gzip format with the data to import
1919
- an optional **schema file**.
2020

21-
Those files have been generated by an [export]({{< relref "about-export.md" >}}) or by a [data migration]({{< relref "about-data-migration.md" >}}) tool.
21+
Those files have been generated by an [export]({{< relref "export-data.md" >}}) or by a [data migration]({{< relref "about-data-migration.md" >}}) tool.
2222

2323

2424
## Importing data on Dgraph Cloud

0 commit comments

Comments
 (0)