Files
genai-toolbox/docs/en/resources/sources/dgraph.md
Anushka Saxena a1def43b35 docs: add available tools for each source (#914)
- This PR adds an `"Available Tools"` section under each source page in
the
[documentation](https://googleapis.github.io/genai-toolbox/resources/sources/).
- The purpose is to help users quickly identify relevant tools
compatible with each data source, improving discoverability and
developer experience.

---------

Signed-off-by: Anushka Saxena <anushkasaxenaa@google.com>
Co-authored-by: Twisha Bansal <58483338+twishabansal@users.noreply.github.com>
2025-07-22 15:53:39 +05:30

2.6 KiB

title, type, weight, description
title type weight description
Dgraph docs 1 Dgraph is fully open-source, built-for-scale graph database for Gen AI workloads

About

Dgraph is an open-source graph database. It is designed for real-time workloads, horizontal scalability, and data flexibility. Implemented as a distributed system, Dgraph processes queries in parallel to deliver the fastest result.

This source can connect to either a self-managed Dgraph cluster or one hosted on Dgraph Cloud. If you're new to Dgraph, the fastest way to get started is to sign up for Dgraph Cloud.

Available Tools

  • dgraph-dql
    Run DQL (Dgraph Query Language) queries.

Requirements

Database User

When connecting to a hosted Dgraph database, this source uses the API key for access. If you are using a dedicated environment, you will additionally need the namespace and user credentials for that namespace.

For connecting to a local or self-hosted Dgraph database, use the namespace and user credentials for that namespace.

Example

sources:
    my-dgraph-source:
        kind: dgraph
        dgraphUrl: https://xxxx.cloud.dgraph.io
        user: ${USER_NAME}
        password: ${PASSWORD}
        apiKey: ${API_KEY}
        namespace : 0

{{< notice tip >}} Use environment variable replacement with the format ${ENV_NAME} instead of hardcoding your secrets into the configuration file. {{< /notice >}}

Reference

Field Type Required Description
kind string true Must be "dgraph".
dgraphUrl string true Connection URI (e.g. "https://xxx.cloud.dgraph.io", "https://localhost:8080").
user string false Name of the Dgraph user to connect as (e.g., "groot").
password string false Password of the Dgraph user (e.g., "password").
apiKey string false API key to connect to a Dgraph Cloud instance.
namespace uint64 false Dgraph namespace (not required for Dgraph Cloud Shared Clusters).