Release Date: June 30, 2020.
For v2.1 and older, see doc-archive.tigergraph.com.
For the running log of bug fixes, see the Change Log.
Major revisions (e.g., from TigerGraph 2 to TigerGraph 3) are the opportunity to deliver significant improvements. While we make every effort to maintain backward compatibility, in selected cases APIs have changed or deprecated features have been dropped, in order to advance the overall product.
Data migration: A tool is available to migrate the data in TigerGraph 2.6 to TigerGraph 3.0. Please contact TigerGraph Support for assistance.
Query and API compatibility:
Some gadmin syntax has changed. Notably.
gadmin set config is now
gadmin config set. Please see Managing with gadmin.
Some features which were previously deprecated have been dropped. Please see V3.0 Removal of Previously Deprecated Features for a detailed list.
TigerGraph 3.0 is a major revision, with several major new features, many smaller feature additions or improvements, and important performance improvements. Users who are currently running
✅ (NEW) User-defined Indexing for Vertex types Users can decide where to add indexes to speed up query performance. Also, available in GraphStudio.
✅ (NEW) Dynamic Querying Queries can now be installed in a generic format, so that the schema specifics (graph, vertex, edge, and attribute names and types) are given as run-time parameters.
✅ More powerful Pattern Matching
Perform ACCUM computation and graph updates on any vertex or edge match in the pattern.
(BETA) Multiple (Conjunctive) Path Patterns: Easily search for complex graph patterns by combining multiple linear paths.
✅ More powerful Distributed Mode queries
Queries run in Distributed mode support nearly the full scope of the GSQL language.
✅ (BETA) No-Code Visual Query Builder for No-Code querying
✅ (ALPHA) No-Code Data Migration from Relational Database to Graph
Run queries in Interpreted Mode
Design and use a MultiGraph schema
Internationalized UI: Chinese now available. Other languages planned
Improved Explore Graph display panel with more options
✅(NEW) User Management Page with Role/Privileges assignment capabilities
✅(NEW) License Overview Page with Resource usage Information
✅(NEW) Export/Import Utility
Export/Import options for just schema, just one graph, with or without user profiles
✅(NEW) Parallel Installer
Significantly faster installation time, especially for clusters
Allows users to maintain more than one set of binaries to be installed
Admin - Better standardization of
gadmin command format
Admin - license key is not displayed in
GSQL - Complex Edge types: one edge type can be used for multiple pairs of vertex types
GSQL - accumulate += vertex and edge attributes in ACCUM & POST-ACCUM
GSQL - can use Global SetAccum accumulators in a FROM clause
GSQL - TYPEDEF accumulator type, for returning results in nested queries
GSQL - FROM clause: Source vertex set has same flexibility as Target vertex set
GSQL - backquote escape to encapsulate username strings
GSQL - string comparison in lexicographical order
GSQL - User's OAuth secret is masked in the output of SHOW USER / SHOW SECRET
GSQL - Reserved Word lists have been greatly reduced
GSQL - Change behavior of CREATE OR REPLACE QUERY - do not install the new query
GSQL/GraphStudio - session timeout with user-configurable time limit
GSQL/GraphStudio - installing a query does not block other users from running queries
REST - query endpoints can use GET (parameters in URL) or POST (parameters in payload)
REST /requesttoken endpoint can use GET or POST
REST - Correction: Use port 14240 to access GSQL server, not 8123
GraphStudio - Users can search for a vertex type on the Design Schema page, to aid the design of large schemas
GraphStudio - Support for Microsoft Internet Explorer and Edge browsers
GraphStudio - Remove 500MD limit on file upload size
GraphStudio - Set query timeout limit
GraphStudio - Refresh the Graph Exploration client with the latest data on the database server
GraphStudio - Improved graph display panel, with persistent menu for zoom in/out, refresh display (re-fetch from the database server), and change layout style.
GraphStudio - Write Queries button to download the query to a file
GraphStudio - accumulator values persist after adjusting the display
Clarified that outdegree() might not report the latest values under heavy workload.
Known Issues for GraphStudio: https://docs.tigergraph.com/ui/graphstudio/known-issues
The No-Code Data Migration feature is in Alpha release. Your feedback would be appreciated.
The No-Code Visual Query Builder is in Beta release. Your feedback would be appreciated.
Known Issues for AdminPortal: https://docs.tigergraph.com/ui/admin-portal-ui-guide/known-issues
Automated Cluster Scale Out
In TigerGraph 3.0, automated cluster scale-out is not supported. There is workaround available using the Backup/Restore utility. Customers are requested to reach out to TigerGraph support for Cluster scale-out operation.
HA/Node Failure Scenarios: Core data service operations like Querying and Updates will work as usual.
Impact of Failure of a node in the cluster:
gadmin operations will not work if one of the nodes is offline. There is workaround available. Metadata operations will not work if one of the nodes is offline. Metadata operations include Install Query / GBAR / GSQL commands such as User and Token management.
m1 node is required to run user-facing applications such as GSQL and GraphStudio. This is because GSQL/Graph Studio metadata is stored on m1 node only.
Multiple (Conjunctive) Path Patterns:
There are no known functional problems, but the performance has not be optimized. Your feedback would be appreciated.
DML type check error in V2 Syntax:
GSQL will report a wrong type check error for Query block with multiple POST-ACCUM clauses and Delete/Update attribute operation.
gstatusgraph (Graph Statistics)
Graph statistics (gstatusgraph) may give inaccurate number when the cluster has node names too similar, where a node name is a part of another node name. It's usually seen in cluster has 10+ nodes.
A quick fix is available at: https://tigergraph.freshdesk.com/support/solutions/articles/5000859550-how-to-patch-gstatusgraph-in-3-0-0