כיצד להתחבר למסד נתונים PostgreSQL באמצעות Node.js

רוב היישומים בעולם האמיתי מקיימים אינטראקציה עם מסדי נתונים בדרך זו או אחרת. מסדי נתונים מקלים על התמדה, ניתוח ואינטראקציה עם נתונים.

רוב שפות התכנות מציעות תמיכה בחיבור יישומים לבסיסי נתונים כמו PostgreSQL. למד כיצד אתה יכול להשתמש במודול node-postgres כדי לחבר יישום Node ל-PostgreSQL.

איך להתחיל

כדי להתחיל בחיבור למסד נתונים מקומי, תצטרך את ה שרת PostgreSQL מותקן.

PostgresSQL היא אחת ממערכות מסדי הנתונים היחסיות הנפוצות ביותר בשל הגמישות והעוצמה שלו. אתה יכול לשקול להשתמש בו כחלופה ל-MySQL אם הפרויקט שלך מורכב או שאתה מחפש פתרון שמאמץ את אתוס הקוד הפתוח.

צור אפליקציית Node

הצעד הראשון הוא ליצור יישום Node שבו תשתמש כדי לבדוק את קוד החיבור. בתיקייה המועדפת עליך, צור תיקיה חדשה.

mkdir postgres-node

נווט אל התיקיה שיצרת ואתחל את npm.

CD postgres-node
npm init -y

פקודה זו אמורה ליצור א package.json קוֹבֶץ.

לאחר מכן, צור קובץ חדש ותן לו שם index.js. אתה תחבר את Node ל-PostgreSQL בקובץ הזה.

השתמש במודול node-postgres

ה node-postgres module הוא חבילת npm המאפשרת לך להתחבר למסד נתונים PostgreSQL ולקיים אינטראקציה איתו. ישנן שתי אפשרויות בהן תוכל להשתמש כדי לחבר את Node עם PostgreSQL באמצעות מודול node-postgres: לקוח בודד או מאגר חיבורים. אז במה כדאי להשתמש?

השתמש בלקוח בודד אם אתה צריך רק חיבור סטטי אחד בכל פעם. עם זאת, אם אתה צריך להשתמש בבקשות במקביל ובקשות מרובות, השתמש במאגר חיבורים.

התקן node-postgres

הפעל את הפקודה הבאה בטרמינל שלך כדי להתקין node-postgres.

npm להתקין עמ'

אם אתה משתמש ב-node >= 14.x, תצטרך להתקין [email protected] o מאוחר יותר. אתה יכול לציין את מספר הגרסה על ידי סיומו לפקודת ההתקנה כך.

npm להתקין pg=8.7.3

מתחבר ל-PostgreSQL

מודול node-postgres דורש את הערכים הבאים כדי להתחבר למסד נתונים PostgreSQL.

• PGUSER - שם משתמש PostgreSQL לחיבור בתור.
• PGHOST - שם מארח השרת שאליו יש להתחבר.
• PGPASSWORD - הסיסמה של שרת PostgreSQL.
• PGDATABASE - שם מסד הנתונים אליו אתה מתחבר.
• PGPORT - מספר היציאה שאליו יש להתחבר במארח השרת.

צור קובץ .env והוסף את המשתנים האלה, תוך החלפת הערכים המתאימים ממסד הנתונים שלך:

PGUSER=<PGUSER>
PGHOST=<PGHOST>
PGPASSWORD=<PGPASSWORD>
PGDATABASE=<PGDATABASE>
PGPORT=<PGPORT>

התקן את חבילת dotenv כדי לגשת לקובץ .env.

npm להתקין dotenv

ב index.js, ייבא והגדר את dotenv.

const dotenv = לִדרוֹשׁ("dotenv")
dotenv.config()

התחבר למסד נתונים PostgreSQL באמצעות לקוח יחיד

הקוד שלהלן מראה כיצד ניתן לחבר את Node לשרת PostgreSQL באמצעות לקוח יחיד.

const { לקוח } = לִדרוֹשׁ("עמוד")
const dotenv = לִדרוֹשׁ("dotenv")
dotenv.config()
const connectDb = אסינכרון () => {
לְנַסוֹת {
const לקוח = חָדָשׁ לָקוּחַ({
מִשׁתַמֵשׁ: תהליך.env.PGUSER,
מנחה: תהליך.env.PGHOST,
מאגר מידע: תהליך.env.PGDATABASE,
סיסמה: תהליך.env.PGPASSWORD,
נמל: תהליך.envPGPORT
 })
לְהַמתִין client.connect()
 const res = await client.query('בחר * מ איזה_טבלה')
לְנַחֵם.log (res)
לְהַמתִין client.end()
 } לתפוס (שגיאה) {
לְנַחֵם.log (שגיאה)
 }
}
connectDb()

שימוש במאגר חיבורים

כפי שכבר צוין, מאגר חיבורים מאפשר לך לבצע מספר בקשות חיבור לשרת שלך.

const { מאגר } = לִדרוֹשׁ("עמוד");
const dotenv = לִדרוֹשׁ("dotenv");
dotenv.config();
const connectDb = אסינכרון () => {
לְנַסוֹת {
const בריכה = חָדָשׁ בריכה({
מִשׁתַמֵשׁ: תהליך.env.PGUSER,
מנחה: תהליך.env.PGHOST,
מאגר מידע: תהליך.env.PGDATABASE,
סיסמה: תהליך.env.PGPASSWORD,
נמל: תהליך.envPGPORT,
 });
לְהַמתִין pool.connect()
 const res = await pool.query('בחר * מ של לקוחות)
לְנַחֵם.log (res)
לְהַמתִין pool.end()
 } לתפוס (שגיאה) {
לְנַחֵם.log (שגיאה)
 }
}
connectDb()

הדוגמאות לעיל מאפשרות לך לשלוט בתצורת מסד הנתונים באמצעות קובץ .env. עם זאת, אתה יכול גם לספק ערכי תצורה אלה באמצעות משתני סביבה סטנדרטיים. גישה זו מאפשרת לך לשנות בקלות את התצורה בזמן ההפעלה.

שקול את קוד החיבור הבא.

const connectDb = אסינכרון () => {
לְנַסוֹת {
const בריכה = חָדָשׁ בריכה();
 const res = await pool.query('בחר * מ של לקוחות)
לְנַחֵם.log (res)
לְהַמתִין pool.end()
 } לתפוס (שגיאה) {
לְנַחֵם.log (שגיאה)
 }
}

בתוכנית זו, אינך מעביר את אובייקט החיבור כארגומנט בעת אתחול Pool. במקום זאת, עליך לציין את פרטי החיבור כאשר אתה מפעיל את התוכנית כך:

PGUSER=<PGUSER> \
PGHOST=<PGHOST> \
PGPASSWORD=<PGPASSWORD> \
PGDATABASE=<PGDATABASE> \
PGPORT=<PGPORT> \
צוֹמֶתאינדקס.js

חיבור Node ל-PostgreSQL כך מאפשר לך לכתוב תוכנית רב פעמית יותר.

לעשות יותר עם PostgreSQL

כדי ליצור יישום המקיים אינטראקציה עם מסדי נתונים, עליך לחבר אותו תחילה למסד הנתונים. במאמר זה, למדת כיצד לחבר את Node למסד נתונים PostgreSQL באמצעות מודול node-Postgres.

מלבד PostgreSQL, ישנן מערכות אחרות לניהול מסד נתונים כמו MySQL שבהן אתה יכול להשתמש ביישום שלך. כלי מסד הנתונים שתבחר צריך להיות תואם ביותר לצרכי הנתונים שלך.