# Golem Add Postgres Moonbit

> Golem Add Postgres Moonbit is an Agent Skill for development published in the golemcloud/golem repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Using golem:rdbms/postgres from a MoonBit Golem agent. Use when the user asks to connect to PostgreSQL, run SQL, or use PostgreSQL from MoonBit agent code.

- Skill name: `golem-add-postgres-moonbit`
- Category: [Development](https://www.openparable.com/skill/development/1)
- Source: https://github.com/golemcloud/golem/blob/HEAD/golem-skills/skills/moonbit/golem-add-postgres-moonbit/SKILL.md
- Repository: golemcloud/golem (1,605 GitHub stars when collected)

## SKILL.md

# Using PostgreSQL from a MoonBit Agent

The MoonBit SDK already includes the generated package for `golem:rdbms/postgres@1.5.0`.

## Add the Package Import

In the component's `moon.pkg`, add an alias for the package:

```text
import {
  "golemcloud/golem_sdk/interface/golem/rdbms/postgres" @pg,
}
```

## Open a Connection

```moonbit
let conn = @pg.DbConnection::open("postgres://user:password@localhost:5432/app")
  .or_error!("failed to connect to PostgreSQL")
```

## Query Data

PostgreSQL placeholders use `$1`, `$2`, ...

```moonbit
let result = conn.query(
  "SELECT $1::text",
  [@pg.DbValue::Text("hello")],
).or_error!("query failed")

let row = result.rows[0]
let value = row.values[0]

let message = match value {
  @pg.DbValue::Text(value) => value
  @pg.DbValue::Varchar(value) => value
  @pg.DbValue::Bpchar(value) => value
  _ => abort("unexpected PostgreSQL value")
}
```

## Execute Statements

```moonbit
conn.execute(
  "INSERT INTO notes (id, body) VALUES ($1, $2)",
  [@pg.DbValue::Int4(1), @pg.DbValue::Text("hello")],
).or_error!("insert failed")
```

## Transactions

```moonbit
let tx = conn.begin_transaction().or_error!("failed to start transaction")
tx.execute(
  "UPDATE notes SET body = $1 WHERE id = $2",
  [@pg.DbValue::Text("updated"), @pg.DbValue::Int4(1)],
).or_error!("update failed")
tx.commit().or_error!("commit failed")
```

---

Source: https://www.openparable.com/skill/development/golem-add-postgres-moonbit (OpenParable). Cite the canonical URL above.
