https://github.com/tembo-io/pg_later

Execute SQL now and get the results later.
https://github.com/tembo-io/pg_later

Last synced: 3 months ago
JSON representation

Execute SQL now and get the results later.

• Host: GitHub
• URL: https://github.com/tembo-io/pg_later
• Owner: tembo-io
• License: postgresql
• Created: 2023-07-24T15:17:35.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-06-25T12:32:26.000Z (5 months ago)
• Last Synced: 2024-06-25T13:58:29.350Z (5 months ago)
• Language: Rust
• Size: 121 KB
• Stars: 334
• Watchers: 10
• Forks: 9
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

• awesome-repositories - tembo-io/pg_later - Execute SQL now and get the results later. (Rust)

README

        
# pg_later

Execute SQL now and get the results later.

A postgres extension to execute queries asynchronously. Built on [pgmq](https://github.com/tembo-io/pgmq).

[![Tembo Cloud Try Free](https://tembo.io/tryFreeButton.svg)](https://cloud.tembo.io/sign-up)

[![Static Badge](https://img.shields.io/badge/%40tembo-community?logo=slack&label=slack)](https://join.slack.com/t/tembocommunity/shared_invite/zt-20dtnhcmo-pLNV7_Aobi50TdTLpfQ~EQ)

[![PGXN version](https://badge.fury.io/pg/pg_later.svg)](https://pgxn.org/dist/pg_later/)

## Installation

### Run with docker

```bash

docker run -p 5432:5432 -e POSTGRES_PASSWORD=postgres quay.io/tembo/pglater-pg:latest

```

If you'd like to build from source, you can follow the instructions in [CONTRIBUTING.md](https://github.com/tembo-io/pg_later/blob/main/CONTRIBUTING.md).

### Using the extension

Initialize the extension's backend:

```sql

CREATE EXTENSION pg_later CASCADE;

SELECT pglater.init();

```

Execute a SQL query now:

```sql

select pglater.exec(

  'select * from pg_available_extensions order by name limit 2'

) as job_id;

```

```text

 job_id 

--------

     1

(1 row)

```

Come back at some later time, and retrieve the results by providing the job id:

```sql

select pglater.fetch_results(1);

```

```text

 pg_later_results

--------------------

{

  "query": "select * from pg_available_extensions order by name limit 2",

  "job_id": 1,

  "result": [

    {

      "name": "adminpack",

      "comment": "administrative functions for PostgreSQL",

      "default_version": "2.1",

      "installed_version": null

    },

    {

      "name": "amcheck",

      "comment": "functions for verifying relation integrity",

      "default_version": "1.3",

      "installed_version": null

    }

  ],

  "status": "success"

}

```