# Triply Documentation > The official documentation for TriplyDB: store, publish and query linked data knowledge graphs. TriplyDB stores, publishes and queries linked data knowledge graphs. Every page below links to its Markdown copy; the HTML page is the same URL without `index.md`. All of them in one file: https://docs.triply.cc/llms-full.txt Pages are grouped by what the reader needs, not by product: tutorials are lessons, how-to guides are tasks, reference is for lookup and concepts explain. A page or passage marked (Preview) describes a feature that is switched on per instance, by arrangement, so not every TriplyDB user has it. ## Tutorials - [Get started with TriplyDB](https://docs.triply.cc/tutorials/getting-started/index.md): From an empty account to a dataset you can query, in four steps and about fifteen minutes. - [Build your first flow](https://docs.triply.cc/tutorials/build-your-first-flow/index.md) (Preview): Build a flow that imports the Iris dataset, selects one species with a CONSTRUCT query and validates the result with SHACL, then run it — in about twenty minutes. - [JSON-LD framing](https://docs.triply.cc/tutorials/json-ld-framing/index.md): Turn the output of a SPARQL Construct query into predictable, tree-shaped JSON with a JSON-LD frame, and serve it from a saved query. - [Build a RESTful API](https://docs.triply.cc/tutorials/building-a-restful-api/index.md): A tutorial that turns a SPARQL query into a RESTful API endpoint on TriplyDB, from writing the iterator to serving the results. ## How-to guides - [Add data](https://docs.triply.cc/how-to/add-data/index.md): Create a dataset in TriplyDB and load linked data into it from files, from a URL, or from an existing dataset. - [Edit SKOS data](https://docs.triply.cc/how-to/edit-skos-data/index.md) (Check your contract): Use the TriplyDB Editor to create, update and delete instances in data shaped by a SKOS or SHACL model. - [Manage services](https://docs.triply.cc/how-to/manage-services/index.md): Create a Virtuoso, Jena or Elasticsearch service for a dataset, keep it in step with its data, and manage every service on the instance. - [Query data](https://docs.triply.cc/how-to/query-data/index.md): Query a TriplyDB dataset from the browser: run SPARQL in the SPARQL IDE, search its text with Elasticsearch, or query it with GraphQL. - [Export data](https://docs.triply.cc/how-to/export-data/index.md): Export a whole dataset or a single graph from TriplyDB, and unpack the compressed TriG file you get back. - [Share and publish data](https://docs.triply.cc/how-to/share-and-publish/index.md): Publish a dataset from TriplyDB: set its access level, add the metadata people and search engines see, and make it discoverable. - [Delete a dataset](https://docs.triply.cc/how-to/delete-a-dataset/index.md): Delete a TriplyDB dataset permanently, and the three things to check before you do. - [Work with saved queries](https://docs.triply.cc/how-to/saved-queries/index.md): Save a SPARQL query in TriplyDB, version it, share it by URL and call it as an API. - [Paginate SPARQL results](https://docs.triply.cc/how-to/sparql-pagination/index.md): Retrieve every result of a SPARQL query in TriplyDB by paginating with the saved query API or with TriplyDB.js. - [Build a data story](https://docs.triply.cc/how-to/data-stories/index.md): Build a data story in TriplyDB: combine saved queries with explanatory text, then publish or embed the result. - [Build a flow](https://docs.triply.cc/how-to/build-a-flow/index.md) (Preview): Create and edit a flow: add and connect tasks, choose what they read and write, branch on a condition, use a saved query, go back to an earlier version, and copy, rename or share a flow. - [Use variables in a flow](https://docs.triply.cc/how-to/use-variables-in-a-flow/index.md) (Preview): Make a flow reusable with variables: define them, use them in task fields and queries, keep credentials in masked values, and save sets of values as presets. - [Run a flow](https://docs.triply.cc/how-to/run-a-flow/index.md) (Preview): Start a flow by hand, from a preset, on a schedule or over HTTP, follow a run, stop it, and find out why it failed. - [Run custom code in a flow](https://docs.triply.cc/how-to/run-custom-code-in-a-flow/index.md) (Preview): Run your own script as a step of a flow, on your own infrastructure, with a connector agent: set up the agent, write the script, and call it from a flow. - [Create an API token](https://docs.triply.cc/how-to/create-an-api-token/index.md): Create an API token so an application, script or pipeline can authenticate against TriplyDB. - [Connect an AI assistant](https://docs.triply.cc/how-to/connect-an-ai-assistant/index.md) (Preview) (Check your contract): Connect an AI assistant to TriplyDB, so you can ask it about your datasets and have it work with them for you. - [Set up a webhook](https://docs.triply.cc/how-to/set-up-a-webhook/index.md): Have TriplyDB call a URL of your choosing whenever data or assets are added to a dataset, for example to trigger a CI pipeline. - [Manage accounts](https://docs.triply.cc/how-to/manage-accounts/index.md): Administrator tasks: restrict who can sign up to a TriplyDB instance, limit how openly content can be shared, create and delete user accounts, and create custom roles for group members. - [Set up redirects](https://docs.triply.cc/how-to/set-up-redirects/index.md): Make the IRIs in your data dereference to the TriplyDB dataset that describes them, with a redirect on your web server and a rule in the admin settings. ## Reference - [HTTP API](https://api.triplydb.com/api-docs) - [GraphQL](https://docs.triply.cc/reference/graphql/index.md) (Check your contract): How TriplyDB builds a GraphQL schema from SHACL shapes, and which queries the endpoint accepts. - [MCP server](https://docs.triply.cc/reference/mcp/index.md) (Preview) (Check your contract): Which MCP revision the TriplyDB MCP server speaks, and every tool it gives an AI assistant. - [TriplyDB-JS](https://static.triply.cc/triplydb-js/) - [Command-line interface](https://static.triply.cc/cli/) - [Saved queries](https://docs.triply.cc/reference/saved-queries/index.md): Look-up tables for saved queries: URL and API patterns, pagination arguments and limits, downloadable result formats, and the metadata fields and GRLC annotations. - [Data views](https://docs.triply.cc/reference/data-views/index.md): The views TriplyDB offers for exploring a dataset — the Linked Data Browser, the Linked Data Table and Insights — and the properties the browser renders specially. - [Flows](https://docs.triply.cc/reference/flows/index.md) (Preview): Look-up tables for Flows: the parts of a flow's page, run statuses, variables, presets and schedules, the HTTP API, permissions and limits. - [Flow tasks](https://docs.triply.cc/reference/flow-tasks/index.md) (Preview): Every task type a flow can use: what it reads, what it writes, and the fields it is configured with. - [Admin settings](https://docs.triply.cc/reference/admin-settings/index.md): Reference for the TriplyDB admin settings pages: site profile, security and access levels, prefixes, roles, users, groups, datasets, services, flows, connector agents, redirects and advanced settings. - [SPARQL introspection functions](https://docs.triply.cc/reference/introspection/index.md): SPARQL functions in TriplyDB that return data about the current environment, such as the name and URL of the current user. - [Supported file formats](https://docs.triply.cc/reference/file-formats/index.md): The data, archive and compression formats TriplyDB accepts, the file name extensions it recognises them by, and how CSV, XML and JSON are converted to RDF. - [Markdown support](https://docs.triply.cc/reference/markdown/index.md): Where TriplyDB accepts Markdown, and which formatting features each place supports. - [Glossary](https://docs.triply.cc/reference/glossary/index.md): Every term used across the Triply documentation, defined once, with links to the page that explains it properly. - [TriplyDB changelog](https://docs.triply.cc/reference/changelog/index.md): Release notes for TriplyDB, listing the new features, improvements and fixes in each version. ## Concepts - [TriplyDB at a glance](https://docs.triply.cc/concepts/what-triplydb-is/index.md): TriplyDB at a glance: what it is for, and the parts it is made of — instances, accounts and nested groups, datasets, graphs, services, saved queries, stories and flows. - [Access control](https://docs.triply.cc/concepts/access-levels/index.md): How access in TriplyDB works: Access Levels decide who can see something, roles decide what a member of a group may do. - [Flows](https://docs.triply.cc/concepts/flows/index.md) (Preview): How Flows works: tasks that act on TriplyDB itself, edges that set their order, variables that make one flow serve many runs, and the runs, schedules and connectors around them. - [Linked data](https://docs.triply.cc/concepts/linked-data/index.md): What linked data is: every fact as a triple, the three kinds of term, and why you would publish this way rather than in a relational database. - [Knowledge graphs](https://docs.triply.cc/concepts/knowledge-graphs/index.md): A working definition of a knowledge graph, how it compares with the alternatives, and what actually goes into building one. - [OWL and ontologies](https://docs.triply.cc/concepts/owl-and-ontologies/index.md): What an ontology contains, what OWL adds on top of plain linked data, and how much of it you have to write yourself. - [SHACL](https://docs.triply.cc/concepts/shacl/index.md): How SHACL states what your data is supposed to look like, what happens when data does not conform, and the second job SHACL does. - [SKOS](https://docs.triply.cc/concepts/skos/index.md): SKOS, the W3C standard for publishing agreed lists of terms as linked data: concept schemes, labels and hierarchies. - [Basics](https://docs.triply.cc/concepts/sparql-basics/index.md): How a SPARQL query is put together — triple patterns, variables, prefixes and modifiers — and what happens when you run one. The first of five chapters on SPARQL. - [Graph patterns](https://docs.triply.cc/concepts/sparql-graph-patterns/index.md): Combining triple patterns, filtering results, and following a chain of relationships you cannot count in advance. - [Aggregation](https://docs.triply.cc/concepts/sparql-aggregation/index.md): Counting, summing and grouping in SPARQL, and the implicit grouping rules that quietly return the wrong table. - [Construct and federation](https://docs.triply.cc/concepts/sparql-construct-and-federation/index.md): The construct, ask and describe query forms, and querying data that lives on someone else's server. - [Real-world data](https://docs.triply.cc/concepts/sparql-real-world-data/index.md): A field guide to the three dataset shapes you meet most often: hierarchies, geometries and statistics. ## TriplyETL - [Overview](https://docs.triply.cc/triply-etl/index.md): TriplyETL builds and maintains production-grade linked data pipelines, in seven steps from source to published knowledge graph. - [Publish](https://docs.triply.cc/triply-etl/publish/index.md): The Publish step loads the finished linked data into a triple store for others to use. ## TriplyETL › Generic - [Getting started](https://docs.triply.cc/triply-etl/generic/getting-started/index.md): Start a TriplyETL project, from the generator and the runner to a pipeline you can run yourself. - [TriplyETL changelog](https://docs.triply.cc/triply-etl/generic/changelog/index.md): Release notes for TriplyETL, and what to check before updating from an older version. - [Command-line interface (CLI)](https://docs.triply.cc/triply-etl/generic/cli/index.md): The TriplyETL command-line interface: the tasks you can run from a terminal, and the flags each one takes. - [Declarations](https://docs.triply.cc/triply-etl/generic/declarations/index.md): Declare the prefixes, graph names and vocabularies a TriplyETL pipeline uses, once, in one place. - [Control structures](https://docs.triply.cc/triply-etl/generic/control-structures/index.md): Branch, loop and skip within a TriplyETL configuration, so a pipeline can vary with the record it is processing. - [Debug](https://docs.triply.cc/triply-etl/generic/debug/index.md): Inspect how data flows through a TriplyETL pipeline, to find where a record stops looking the way you expected. - [Internal store](https://docs.triply.cc/triply-etl/generic/internal-store/index.md): The internal store holds the linked data a pipeline has asserted so far, and is what the Enrich and Validate steps work on. - [Maintenance](https://docs.triply.cc/triply-etl/generic/maintenance/index.md): Keeping a configured TriplyETL repository running: updating the dependency, and the functionality that supports it. - [Record](https://docs.triply.cc/triply-etl/generic/record/index.md): The Record is TriplyETL's format-independent view of one unit of source data, and what every transformation operates on. - [Skolem IRIs](https://docs.triply.cc/triply-etl/generic/skolem-iris/index.md): Why TriplyETL uses Skolem IRIs in place of blank nodes, and how they behave in their stead. - [Supported vocabularies](https://docs.triply.cc/triply-etl/generic/vocabularies/index.md): The external vocabularies TriplyETL supports out of the box, and how to use one that is not listed. ## TriplyETL › Sources - [Overview](https://docs.triply.cc/triply-etl/sources/index.md): The locations TriplyETL can read data from, and which extractor goes with each of them. - [APIs](https://docs.triply.cc/triply-etl/sources/apis/index.md): Extract records from an online endpoint or API, including paged and authenticated ones. - [Inline JSON](https://docs.triply.cc/triply-etl/sources/inline-json/index.md): Write JSON data straight into a TriplyETL configuration as a TypeScript object, with no file in between. - [Inline strings](https://docs.triply.cc/triply-etl/sources/inline-strings/index.md): Specify JSON or RDF data as a string inside a TriplyETL configuration, which is what makes a self-contained example possible. - [Local files](https://docs.triply.cc/triply-etl/sources/local-files/index.md): Read data from files on the machine the pipeline runs on, with Source.file(). - [Online files](https://docs.triply.cc/triply-etl/sources/online-files/index.md): Read data from a file published on a server, with Source.url(), and why that is rarely right for production. - [TriplyDB assets](https://docs.triply.cc/triply-etl/sources/triplydb-assets/index.md): Use a file stored as a TriplyDB asset as a pipeline source, so source data is versioned alongside the dataset. - [TriplyDB datasets](https://docs.triply.cc/triply-etl/sources/triplydb-datasets/index.md): Load the graphs of a TriplyDB dataset into a pipeline's internal store. - [TriplyDB queries](https://docs.triply.cc/triply-etl/sources/triplydb-queries/index.md): Use a saved SPARQL query in TriplyDB as a pipeline source, with a different extractor per query form. ## TriplyETL › Extract - [Overview](https://docs.triply.cc/triply-etl/extract/index.md): The Extract step turns source data into a stream of Records, and is where every TriplyETL pipeline begins. - [CSV extractor](https://docs.triply.cc/triply-etl/extract/csv/index.md): Read comma-separated tabular data into Records with the fromCsv() extractor. - [JSON extractor](https://docs.triply.cc/triply-etl/extract/json/index.md): Read tree-shaped JSON data into Records with the fromJson() extractor. - [OAI-PMH extractor](https://docs.triply.cc/triply-etl/extract/oai-pmh/index.md): Harvest metadata from an OAI-PMH endpoint, the publishing protocol common in galleries, libraries, archives and museums. - [Postgres extractor](https://docs.triply.cc/triply-etl/extract/postgres/index.md): Read rows from a PostgreSQL database into Records with the fromPostgres() extractor. - [RDF loader](https://docs.triply.cc/triply-etl/extract/rdf/index.md): Load RDF straight into the internal store with loadRdf(), rather than extracting Records from it. - [Shapefile extractor](https://docs.triply.cc/triply-etl/extract/shapefile/index.md): Read geographic features from an ESRI Shapefile into Records, for GIS data that arrives as a zipped set of files. - [TSV extractor](https://docs.triply.cc/triply-etl/extract/tsv/index.md): Read tab-separated tabular data into Records with the fromTsv() extractor. - [XLSX extractor](https://docs.triply.cc/triply-etl/extract/xlsx/index.md): Read Microsoft Excel workbooks into Records with the fromXlsx() extractor. - [XML extractor](https://docs.triply.cc/triply-etl/extract/xml/index.md): Read tree-shaped XML data into Records with the fromXml() extractor. ## TriplyETL › Transform - [Overview](https://docs.triply.cc/triply-etl/transform/index.md): The Transform step reshapes the Record before anything is asserted from it. - [RATT transformations](https://docs.triply.cc/triply-etl/transform/ratt/index.md): The core set of TriplyETL transformation functions, which cover the large majority of changes a Record needs. - [RML transformations](https://docs.triply.cc/triply-etl/transform/rml/index.md): Apply an RML mapping to the Record, for pipelines that already have one or must share it with other tooling. - [TypeScript transformations](https://docs.triply.cc/triply-etl/transform/typescript/index.md): Write a custom transformation in TypeScript, for the cases the core functions do not cover. - [XSLT transformations](https://docs.triply.cc/triply-etl/transform/xslt/index.md): Transform XML source data with an XSLT stylesheet before it reaches the rest of the pipeline. ## TriplyETL › Assert - [Overview](https://docs.triply.cc/triply-etl/assert/index.md): The Assert step turns data in the Record into linked data in the internal store. - [JSON-LD assertions](https://docs.triply.cc/triply-etl/assert/json-ld/index.md): Assert linked data from JSON-LD, using the standard's own algorithms. ## TriplyETL › Assert › RATT - [Term assertions](https://docs.triply.cc/triply-etl/assert/ratt/terms/index.md): The RATT functions that create RDF terms — IRIs, literals and lists — for use in statement assertions. - [Statement assertions](https://docs.triply.cc/triply-etl/assert/ratt/statements/index.md): The RATT functions that assert triples and quads into the internal store. ## TriplyETL › Enrich - [Overview](https://docs.triply.cc/triply-etl/enrich/index.md): The Enrich step derives new linked data from the linked data a pipeline has already asserted. ## TriplyETL › Enrich › SHACL - [Overview](https://docs.triply.cc/triply-etl/enrich/shacl/index.md): SHACL Rules add data to the internal store from data already in it, as part of the data model rather than beside it. - [Triple rules](https://docs.triply.cc/triply-etl/enrich/shacl/triple-rules/index.md): Triple Rules assert one statement each, and are the simpler half of SHACL Rules. - [SPARQL rules](https://docs.triply.cc/triply-etl/enrich/shacl/sparql-rules/index.md): SPARQL Rules use the full query language, for enrichment that Triple Rules cannot express. ## TriplyETL › Enrich › SPARQL - [SPARQL Construct](https://docs.triply.cc/triply-etl/enrich/sparql/construct/index.md): Enrich the internal store with the results of a SPARQL Construct query. - [SPARQL Update](https://docs.triply.cc/triply-etl/enrich/sparql/update/index.md): Modify and extend the internal store with SPARQL Update. ## TriplyETL › Validate - [Overview](https://docs.triply.cc/triply-etl/validate/index.md): The Validate step checks the produced linked data against the data model, so that only conforming data is published. - [Graph comparison](https://docs.triply.cc/triply-etl/validate/graph-comparison/index.md): Check that a pipeline produces exactly the graph you specified by hand, record for record. - [SHACL validation](https://docs.triply.cc/triply-etl/validate/shacl/index.md): Validate the internal store against SHACL shapes, and read the report that comes back.