Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/apache/age
Graph database optimized for fast analysis and real-time data processing. It is provided as an extension to PostgreSQL.
https://github.com/apache/age
age-database agensgraph analytics graph-database graphdb multi-model-dbms postgresql postgresql-extension
Last synced: 2 days ago
JSON representation
Graph database optimized for fast analysis and real-time data processing. It is provided as an extension to PostgreSQL.
- Host: GitHub
- URL: https://github.com/apache/age
- Owner: apache
- License: apache-2.0
- Created: 2020-07-01T06:15:47.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2024-09-27T17:51:11.000Z (3 months ago)
- Last Synced: 2024-10-29T10:27:22.626Z (about 1 month ago)
- Topics: age-database, agensgraph, analytics, graph-database, graphdb, multi-model-dbms, postgresql, postgresql-extension
- Language: C
- Homepage: https://age.apache.org
- Size: 45.4 MB
- Stars: 3,096
- Watchers: 67
- Forks: 409
- Open Issues: 154
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-repositories - apache/age - Graph database optimized for fast analysis and real-time data processing. It is provided as an extension to PostgreSQL. (C)
- my-awesome - apache/age - database,agensgraph,analytics,graph-database,graphdb,multi-model-dbms,postgresql,postgresql-extension pushed_at:2024-09 star:3.2k fork:0.4k Graph database optimized for fast analysis and real-time data processing. It is provided as an extension to PostgreSQL. (C)
- awesome-dataops - Age - A multi-model database that supports both graph and relational data models. (Database / Graph Database)
README
is a leading multi-model graph database
Graph Processing & Analytics for Relational Databases
What is Apache AGE?[Apache AGE](https://age.apache.org/#) is an extension for PostgreSQL that enables users to leverage a graph database on top of the existing relational databases. AGE is an acronym for A Graph Extension and is inspired by Bitnine's AgensGraph, a multi-model database fork of PostgreSQL. The basic principle of the project is to create a single storage that handles both the relational and graph data model so that the users can use the standard ANSI SQL along with openCypher, one of the most popular graph query languages today. There is a strong need for cohesive, easy-to-implement multi-model databases. As an extension of PostgreSQL, AGE supports all the functionalities and features of PostgreSQL while also offering a graph model to boot.
OverviewApache AGE is :
- **Powerful**: adds graph database support to the already popular PostgreSQL database: PostgreSQL is used by organizations including Apple, Spotify, and NASA.
- **Flexible**: allows you to perform openCypher queries, which makes complex queries much easier to write. It also enables querying multiple graphs at the same time.
- **Intelligent**: allows you to perform graph queries that are the basis for many next-level web services such as fraud detection, master data management, product recommendations, identity and relationship management, experience personalization, knowledge management, and more.
Features
- **Cypher Query**: supports graph query language
- **Hybrid Querying**: enables SQL and/or Cypher
- **Querying**: enables multiple graphs
- **Hierarchical**: graph label organization
- **Property Indexes**: on both vertices(nodes) and edges
- **Full PostgreSQL**: supports PG features
DocumentationRefer to our latest [Apache AGE documentation](https://age.apache.org/age-manual/master/index.html) to learn about installation, features, built-in functions, and Cypher queries.
Pre-InstallationInstall the following essential libraries according to each OS. Building AGE from the source depends on the following Linux libraries (Ubuntu package names shown below):
- **CentOS**
```bash
yum install gcc glibc glib-common readline readline-devel zlib zlib-devel flex bison
```
- **Fedora**
```bash
dnf install gcc glibc bison flex readline readline-devel zlib zlib-devel
```
- **Ubuntu**
```bash
sudo apt-get install build-essential libreadline-dev zlib1g-dev flex bison
```
InstallationApache AGE is intended to be simple to install and run. It can be installed with Docker and other traditional ways.
Install PostgreSQLYou will need to install an AGE compatible version of Postgres, for now AGE supports Postgres 11, 12, 13, 14, 15 & 16. Supporting the latest versions is on AGE roadmap.
Installation via Package ManagerYou can use a package management that your OS provides to download PostgreSQL.
```bash
sudo apt install postgresql```
Installation From Source CodeYou can download the Postgres source code and install your own instance of Postgres. You can read instructions on how to install from source code for different versions on the official Postgres Website.
Install AGE on Linux and MacOSClone the github repository or download the download an official release.
Run the pg_config utility and check the version of PostgreSQL. Currently, only PostgreSQL versions 11, 12, 13, 14, 15 & 16 are supported. If you have any other version of Postgres, you will need to install PostgreSQL version 11, 12, 13, 14, 15, or 16.
```bash
pg_config
```
Run the following command in the source code directory of Apache AGE to build and install the extension.
```bash
make install
```
If the path to your Postgres installation is not in the PATH variable, add the path in the arguments:
```bash
make PG_CONFIG=/path/to/postgres/bin/pg_config install
```
Run using DockerGet the docker image
```bash
docker pull apache/age```
Create AGE docker container
```bash
docker run \
--name age \
-p 5455:5432 \
-e POSTGRES_USER=postgresUser \
-e POSTGRES_PASSWORD=postgresPW \
-e POSTGRES_DB=postgresDB \
-d \
apache/age
```Enter PostgreSQL's psql:
```bash
docker exec -it age psql -d postgresDB -U postgresUser
```
Post InstallationFor every connection of AGE you start, you will need to load the AGE extension.
```bash
CREATE EXTENSION age;
```
```bash
LOAD 'age';
```
```bash
SET search_path = ag_catalog, "$user", public;
```
Quick StartTo create a graph, use the create_graph function located in the ag_catalog namespace.
```bash
SELECT create_graph('graph_name');
```To create a single vertex with label and properties, use the CREATE clause.
```bash
SELECT *
FROM cypher('graph_name', $$
CREATE (:label {property:"Node A"})
$$) as (v agtype);
``````bash
SELECT *
FROM cypher('graph_name', $$
CREATE (:label {property:"Node B"})
$$) as (v agtype);
```To create an edge between two nodes and set its properties:
```bash
SELECT *
FROM cypher('graph_name', $$
MATCH (a:label), (b:label)
WHERE a.property = 'Node A' AND b.property = 'Node B'
CREATE (a)-[e:RELTYPE {property:a.property + '<->' + b.property}]->(b)
RETURN e
$$) as (e agtype);
```And to query the connected nodes:
```
SELECT * from cypher('graph_name', $$
MATCH (V)-[R]-(V2)
RETURN V,R,V2
$$) as (V agtype, R agtype, V2 agtype);
```
Language Specific DriversStarting with Apache AGE is very simple. You can easily select your platform and incorporate the relevant SDK into your code.
Built-in
- [Go driver](./drivers/golang)
- [Java driver](./drivers/jdbc)
- [NodeJs driver](./drivers/nodejs)
- [Python driver](./drivers/python)Community-driven Driver
- [Apache AGE Rust Driver](https://github.com/Dzordzu/rust-apache-age.git)
- [Apache AGE .NET Driver](https://github.com/Allison-E/pg-age)
Graph Visualization Tool for AGEApache AGE Viewer is a user interface for Apache AGE that provides visualization and exploration of data.
This web visualization tool allows users to enter complex graph queries and explore the results in graph and table forms.
Apache AGE Viewer is enhanced to proceed with extensive graph data and discover insights through various graph algorithms.
Apache AGE Viewer will become a graph data administration and development platform for Apache AGE to support multiple relational databases: .**This is a visualization tool.**
After installing AGE Extension, you may use this tool to get access to the visualization features.![Viewer gdb, and graph](/img/agce.gif)
Video LinksYou can also get help from these videos.
- Install on [Windows](https://www.youtube.com/watch?v=ddk8VX8Hm-I&list=PLGp3huJbWNDjgwP7s99Q-9_w1vxpjNHXG)
- Install on [MacOS](https://www.youtube.com/watch?v=0-qMwpDh0CA)
ContributingYou can improve ongoing efforts or initiate new ones by sending pull requests to [this repository](https://github.com/apache/age).
Also, you can learn from the code review process, how to merge pull requests, and from code style compliance to documentation by visiting the [Apache AGE official site - Developer Guidelines](https://age.apache.org/contribution/guide).
Send all your comments and inquiries to the user mailing list, [email protected].