Velo by Wix is a development platform built on top of Wix, adding a built-in database and node.js backend. The built-in database is a document based database optimized for websites and content. Depending on the specific workload, it can support 10K - 100K records, and for some workloads even more. It is globally replicated, has native support for PII encryption, GDPR, and other non-functional features. It runs on shared infrastructure and is fully managed by Wix.
However, requirements for data locality, regulations, data ownership, dedicated infrastructure, or workloads that demand specific engines may require an external database. This adapter enables connecting external database engines to your site.
Velo lets you connect an “external database” and map the structures of the underlying tables as wix-data collections. Once connected, you can work with the database and it’s collections in your site just as you would with the built-in database.
You can use wix-data APIs, display data from an external database collection in Wix Editor elements, use the data to create dynamic pages, and connect it to user input elements.
This project is a reference implementation of the wix-data SPI, allowing the development or extension of alternative external database adapters, to connect Velo with external databases.
For a detailed guide to installing and integrating this adapter on Google Cloud Platform, see the Integrate Your Google Cloud MySQL or Postgres Database with Your Velo Site article. If you are deploying to AWS, please follow the Integrate Your AWS RDS Database with Your Velo Site tutorial.
The external database adapter is a Node.js server that implements the wix-data SPI. The server communicates with the database using the database's native protocol. It then translates the data into wix-data format and communicates with the Wix site via the wix-data SPI.
Wix maintains a pre-built Docker container image that is ready to be deployed. Your should run the container as close as possible to a database to minimize the latency of the native DB protocol traffic between the adapter and the database. Additionally, some databases require persistent connections and are not suited to HTTP. Security and firewall configurations between the adapter and database should also be considered.
It is important to note the location of the deployed environment. The Wix infrastructure has a global presence, and site data is replicated worldwide to give your site visitors the best performance. Where the database is managed externally, it is important to set up the adapter and the database in the correct region for optimal performance.
The following lists the databases supported by the adapter:
- MySQL
Supported vanilla MySQL versions: 5.7 to 8.0.
While MySQL variants like MariaDB and Percona Server for MySQL have not been tested, they claim to be fully compatible with MySQL and therefore are assumed to work. The following managed versions of MySQL work with the adapter: - Postgres
Supported versions 12, 13.
Managed versions available:
The adapter is a Docker container image, It is supported by any cloud environment that supports Docker containers. This includes:
- Google Cloud
- Deploying to Cloud Run
- Deploying to AppEngine
- Amazon Web Services
- Microsoft Azure
- Deploying to Azure App Services
- Deploying to Azure Container service
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent