Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

[Docs/GIE] GIE documentations refine and extend #2598

Open
10 tasks
longbinlai opened this issue Apr 12, 2023 · 0 comments
Open
10 tasks

[Docs/GIE] GIE documentations refine and extend #2598

longbinlai opened this issue Apr 12, 2023 · 0 comments
Assignees
Labels
component:doc Improvements or additions to documentation component:gie

Comments

@longbinlai
Copy link
Collaborator

longbinlai commented Apr 12, 2023

Overview

Provide an overview and introduction of the gie-db.
Must briefly introduce the property graph model,
give some insightful examples etc.

Installation

Introduce everything related to how to install the gie-db

System requirements

Hardware/Software requirements, versions & limitations

Linux installation (might fork the following for a Mac machine)

Instruct how to install on a Linux machine

Tarball executable

Download pre-compiled tarball from the website.

Pip install

A wheel package to allow users installing from pip, a consistent experience as GraphScope

Compile from source codes

Download from source code and due local compilation, potentially via:

gs dev make db
gs dev make install db ?

Configuration

Describe each configurable items of the gs_db.yaml

Benchmark

Provide our current ldbc benchmark results, potentially audited

Development

Stored procedure

Introduce the apis for helping users developing a stored procedure for gie_db

Tools

The db admin tool

The admin tool is maintain in the bin directory, co-designed with the gs cli tool.

gs db admin

We current provide the following to entry for the admin tool:

  • server: manage the server-related operations
    • start: Starts the server as a daemon.
    • stop: Stops the server daemon.
    • status: Gets the status of the server.
    • restart: Restarts the server daemon.
  • database: manage the database-related operations
    • import: imports a collection of CSV files, must provide the data_import.yaml
    • compile: to compiler a c++/cypher file into a stored procedure
gs db admin --help

gs db admin import <graph_name> -f[--folder] </path/to/raw/data> -c[--conf] data_import.yaml

gs db admin compiler <source_file[.cc, .so]> -o </path/to/plugins> [other configurations]

Cypher-shell

Just briefly introduce that we use Neo4j's official Cypher-shell.

The following does not belong to the current production stage, but need to further consider:

Gremlin SDK

  • Gremlin Compatibility (a table with supported tick yes, unsupported tick no) @shirly121
  • Gremlin Supported Steps (with extended description for syntactic sugar) @longbinlai
  • Python @longbinlai
  • Gremlin 查询可配置参数:超时等等 @shirly121

Cypher SDK

Found several nice case in https://help.aliyun.com/document_detail/112465.html?spm=a2c4g.112470.0.0.4be243cflDDABM @BingqingLyu

  • Bank and Finances
  • Social Network
  • Anti-Fraud
  • Recommendation
@longbinlai longbinlai added component:doc Improvements or additions to documentation component:gie labels Apr 12, 2023
longbinlai added a commit that referenced this issue Jun 20, 2023
…ecosystem (#2848)

<!--
Thanks for your contribution! please review
https://github.com/alibaba/GraphScope/blob/main/CONTRIBUTING.md before
opening an issue.
-->

## What do these changes do?
1. introdure `GraphServer` which wrappers `IrGremlinServer` (gremlin
service) and `CommunityBootstrapper` (cypher service)
2. remove cypher service from gremlin stack
3. add document of neo4j ecosystem

<!-- Please give a short brief about these changes. -->

## Related issue number

<!-- Are there any issues opened that will be resolved by merging this
change? -->

#2598

---------

Co-authored-by: siyuan0322 <[email protected]>
Co-authored-by: Longbin Lai <[email protected]>
Co-authored-by: longbinlai <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
component:doc Improvements or additions to documentation component:gie
Projects
None yet
Development

No branches or pull requests

3 participants