prisma-postgres

--- Conseils de configuration et d'opération de Prisma Postgres dans Console, CLI create-db, API de gestion et SDK API de gestion. À utiliser lors de la création de bases de données Prisma Postgres, du travail dans Prisma Console, de la mise à disposition avec create-db/create-pg/create-postgres, ou de l'intégration de la mise à disposition programmatique avec des jetons de service ou OAuth.

npx skills add https://github.com/prisma/skills --skill prisma-postgres

Prisma Postgres

Conseils pour créer, gérer et intégrer Prisma Postgres dans les flux de travail interactifs et programmatiques.

Quand l'appliquer

Consultez cette compétence quand :

  • Configuration de Prisma Postgres depuis Prisma Console
  • Provisionnement de bases de données temporaires instantanées avec create-db
  • Liaison d'un projet local existant avec prisma postgres link
  • Gestion des ressources Prisma Postgres via Management API
  • Utilisation de @prisma/management-api-sdk en TypeScript/JavaScript
  • Traitement des URL de réclamation, chaînes de connexion, régions et flux d'authentification

Catégories de règles par priorité

Priorité Catégorie Impact Préfixe
1 Provisionnement CLI CRITIQUE create-db-cli
2 Management API CRITIQUE management-api
3 Management API SDK ÉLEVÉ management-api-sdk
4 Console et connexions ÉLEVÉ console-and-connections

Référence rapide

  • create-db-cli - bases de données instantanées et drapeaux CLI actuels (--ttl, --copy, --quiet, --open)
  • management-api - flux de travail avec jeton de service et API OAuth
  • management-api-sdk - utilisation du SDK typé avec stockage de jeton
  • console-and-connections - opérations Console, prisma postgres link, connexions TCP directes et choix du serverless-driver

Flux de travail principaux

1. Flux basé sur la Console

Utilisez Prisma Console pour les opérations et la configuration manuelle :

  • Ouvrir https://console.prisma.io
  • Créer/sélectionner un espace de travail et un projet
  • Utiliser Studio dans la barre latérale du projet pour afficher/modifier les données
  • Récupérer les détails de connexion directe depuis l'interface utilisateur du projet

2. Provisionnement rapide avec create-db

Utilisez create-db quand vous avez besoin d'une base de données immédiatement :

npx create-db@latest

Alias :

npx create-pg@latest
npx create-postgres@latest

Pour les intégrations d'applications, vous pouvez également utiliser l'API programmatique (create() / regions()) du package npm create-db.

Les bases de données temporaires se suppriment automatiquement après environ 24 heures sauf si elles sont réclamées.

3. Lier un projet local existant

Utilisez prisma postgres link quand la base de données existe déjà et que vous voulez connecter un projet local à celle-ci :

prisma postgres link

Pour CI ou autres environnements non-interactifs :

prisma postgres link --api-key "<your-api-key>" --database "db_..."

Ce flux met à jour votre .env local avec DATABASE_URL, puis vous pouvez exécuter prisma generate et prisma migrate dev.

4. Provisionnement programmatique avec Management API

Utilisez les points de terminaison sur :

https://api.prisma.io/v1

Explorez le schéma et les points de terminaison en utilisant :

  • Documentation OpenAPI : https://api.prisma.io/v1/doc
  • Swagger Editor : https://api.prisma.io/v1/swagger-editor

Options d'authentification :

  • Jeton de service (serveur à serveur de l'espace de travail)
  • OAuth 2.0 (agir au nom des utilisateurs)

5. Intégration type-safe avec Management API SDK

Installez et utilisez :

npm install @prisma/management-api-sdk

Utilisez createManagementApiClient pour les jetons existants, ou createManagementApiSdk pour OAuth + actualisation du jeton.

Fichiers de règles

Les conseils détaillés se trouvent dans :

references/console-and-connections.md
references/create-db-cli.md
references/management-api.md
references/management-api-sdk.md

Comment utiliser

Commencez par references/create-db-cli.md pour une configuration rapide, puis basculez vers references/management-api.md ou references/management-api-sdk.md quand vous avez besoin d'un provisionnement programmatique.