https://github.com/wgliang/pgproxy

PostgreSQL proxy server.
https://github.com/wgliang/pgproxy

database postgresql proxy-server

Last synced: 6 days ago
JSON representation

PostgreSQL proxy server.

• Host: GitHub
• URL: https://github.com/wgliang/pgproxy
• Owner: wgliang
• License: apache-2.0
• Created: 2017-02-08T06:48:20.000Z (almost 8 years ago)
• Default Branch: master
• Last Pushed: 2017-05-02T03:32:12.000Z (over 7 years ago)
• Last Synced: 2024-12-12T23:33:57.233Z (13 days ago)
• Topics: database, postgresql, proxy-server
• Language: Go
• Size: 5.66 MB
• Stars: 213
• Watchers: 11
• Forks: 36
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
![pgproxy](./pgproxy.png)

# pgproxy

[![Build Status](https://travis-ci.org/wgliang/pgproxy.svg?branch=master)](https://travis-ci.org/wgliang/pgproxy)

[![codecov](https://codecov.io/gh/wgliang/pgproxy/branch/master/graph/badge.svg)](https://codecov.io/gh/wgliang/pgproxy)

[![GoDoc](https://godoc.org/github.com/wgliang/pgproxy?status.svg)](https://godoc.org/github.com/wgliang/pgproxy)

[![Code Health](https://landscape.io/github/wgliang/pgproxy/master/landscape.svg?style=flat)](https://landscape.io/github/wgliang/pgproxy/master)

[![Code Issues](https://www.quantifiedcode.com/api/v1/project/98b2cb0efd774c5fa8f9299c4f96a8c5/badge.svg)](https://www.quantifiedcode.com/app/project/98b2cb0efd774c5fa8f9299c4f96a8c5)

[![Go Report Card](https://goreportcard.com/badge/github.com/wgliang/pgproxy)](https://goreportcard.com/report/github.com/wgliang/pgproxy)

[![License](https://img.shields.io/badge/LICENSE-Apache2.0-ff69b4.svg)](http://www.apache.org/licenses/LICENSE-2.0.html)

pgproxy is a postgresql proxy server, through a pipe redirect connection, which allows you to filter the requested sql statement. In the future it will support multi-database backup, adapt to distributed databases and other schemes except the  analyze sql statement.

You can do:

* database read and write separation

* database services disaster recovery

* proxy database

* rewrite sql statement

* filter dangerous sql

* monitor database operations

* sql requests current limit and merge

## Installation

```

$ go get -u github.com/wgliang/pgproxy

```

## Using

### As a separate application

Start or shut down the proxy server.

```

$ pgproxy start/stop

```

Use pgproxy on the command line

```

$ pgproxy cli

```

Ps: You can use it as you would with a native command line.

### Be called as a package

[package_example](https://github.com/wgliang/pgproxy/blob/master/examples/package_example.go)

```

package main

import (

	"fmt"

	"os"

	"os/signal"

	"syscall"

	"github.com/wgliang/pgproxy/cli"

)

func main() {

	// call proxy

	cli.Main("../pgproxy.conf", []string{"pgproxy", "start"})

	

	// 捕获ctrl-c,平滑退出

	chExit := make(chan os.Signal, 1)

	signal.Notify(chExit, syscall.SIGINT, syscall.SIGTERM, syscall.SIGKILL)

	select {

	case <-chExit:

		fmt.Println("Example EXITING...Bye.")

	}

}

```

## Support

select/delete/update statement and support any case.

On the support of the sql standard：

The parser is forked from vitess's [sqlparser](https://github.com/youtube/vitess/tree/master/go/vt/sqlparser) of youtube.

In pgproxy, database tables are like MySQL(5.6,5.7) relational tables, and you can use relational modeling schemes (normalization) to structure your schema. It supports almost all MySQL(5.6,5.7) scalar data types. It also provides full SQL support within a shard, including JOIN statements. Some postgresql operations are not supported,detail see [support type and keywords](https://github.com/wgliang/pgproxy/blob/master/parser/token.go#L37).

## Credits

Package parser is based on [sqlparser](https://github.com/xwb1989/sqlparser)