ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะได้เรียนรู้วิธีต่อไปนี้
- เพิ่ม Firebase Data Connect ลงในโปรเจ็กต์ Firebase
- ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์รวมถึงส่วนขยายโค้ด Visual Studio เพื่อทำงานกับอินสแตนซ์เวอร์ชันที่ใช้งานจริง
- จากนั้นเราจะแสดงวิธีการต่อไปนี้
- สร้างสคีมาโดยใช้ตัวอย่างแอปอีเมล
- กำหนดการค้นหาและการเปลี่ยนแปลงสำหรับสคีมา
- ใช้ SDK ที่สร้างขึ้นโดยอัตโนมัติในการเรียกใช้การค้นหาและการเปลี่ยนแปลงเหล่านี้จากไคลเอ็นต์
- นำต้นแบบขั้นสุดท้ายไปใช้จริง
สิ่งที่ต้องดำเนินการก่อน
คุณต้องมีสิ่งต่อไปนี้เพื่อใช้การเริ่มต้นอย่างรวดเร็วนี้
- Linux, macOS หรือ Windows
- โค้ด Visual Studio
เพิ่ม Data Connect ลงในโปรเจ็กต์และสร้างแหล่งข้อมูล
- สร้างโปรเจ็กต์ Firebase หากยังไม่ได้ทำ
- ในคอนโซล Firebase ให้คลิกเพิ่มโปรเจ็กต์ จากนั้นทำตามวิธีการบนหน้าจอ
อัปเกรดโปรเจ็กต์เป็นแพ็กเกจ Blaze วิธีนี้ช่วยให้คุณสร้างอินสแตนซ์ Cloud SQL สำหรับ PostgreSQL ได้
ไปที่ส่วน Data Connect ของคอนโซล Firebase และทำตามขั้นตอนการตั้งค่าผลิตภัณฑ์
เลือกตำแหน่งสำหรับฐานข้อมูล CloudSQL สำหรับ PostgreSQL
จดชื่อโปรเจ็กต์ บริการ และฐานข้อมูลเพื่อยืนยันในภายหลัง
ทำตามขั้นตอนการตั้งค่าที่เหลือแล้วคลิกเสร็จสิ้น
เลือกและตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์
เริ่มจาก Data Connect ด้วยการสร้างต้นแบบแอปในโค้ด Visual Studio
หรือคุณจะติดตั้งฐานข้อมูล PostgreSQL ในเครื่องสำหรับการพัฒนาภายในด้วยโปรแกรมจำลอง Data Connect ก็ได้ การตั้งค่านี้ครอบคลุมอยู่ที่ส่วนท้ายของคู่มือการเริ่มต้นอย่างรวดเร็วนี้
Data Connect สนับสนุนการพัฒนา 2 รูปแบบสำหรับการสร้างต้นแบบ ได้แก่
- หากคุณเป็นนักพัฒนาซอฟต์แวร์เว็บหรือ Kotlin Android คุณสามารถสร้างต้นแบบของสคีมาและการดำเนินการภายในเครื่องได้ขณะเชื่อมต่อกับอินสแตนซ์ Cloud SQL สำหรับ PostgreSQL หรือเรียกใช้ PostgreSQL ในเครื่อง (ไม่บังคับ)
หากคุณเป็นนักพัฒนาซอฟต์แวร์เว็บ คุณสามารถใช้ IDX เพื่อสร้างต้นแบบในพื้นที่ทำงานของ IDX โดยใช้เทมเพลต IDX ที่กำหนดค่าล่วงหน้าด้วย PostgreSQL, ส่วนขยายโค้ด VS ด้วยโปรแกรมจำลอง Data Connect และสร้างโค้ดการเริ่มต้นอย่างรวดเร็วให้คุณ
การพัฒนาโค้ด VS
หากต้องการพัฒนาในพื้นที่แทนการใช้ IDX ให้ตั้งค่าส่วนขยาย Firebase VS Code เพื่อช่วยให้คุณพัฒนาการพัฒนาได้อย่างรวดเร็วด้วยการสร้าง SDK สำหรับเว็บ, Kotlin Android และ iOS ที่จะมีให้บริการเร็วๆ นี้
- สร้างไดเรกทอรีใหม่สำหรับโปรเจ็กต์ในเครื่อง
- เปิด VS Code ในไดเรกทอรีใหม่
- ดาวน์โหลดส่วนขยายซึ่งรวมเป็นแพ็กเกจ VSIX จากพื้นที่เก็บข้อมูลของ Firebase
- ใน VS Code ให้เลือกส่วนขยายจากเมนูมุมมอง
- ในแถบชื่อแผงส่วนขยาย ให้คลิกไอคอนเมนู more_horiz จากนั้นทำตามวิธีติดตั้งจาก VSIX...
การพัฒนา IDX
IDX คือสภาพแวดล้อมที่ได้รับการเพิ่มประสิทธิภาพสำหรับการพัฒนาเว็บแอป หากคุณเป็นนักพัฒนาซอฟต์แวร์ Kotlin สำหรับ Android ให้ทำตามขั้นตอนในแท็บการพัฒนาโค้ด VS
วิธีตั้งค่าเทมเพลต Data Connect IDX
- เข้าถึงเทมเพลตที่เว็บไซต์ Project IDX
- ทำตามขั้นตอนการตั้งค่า
ตั้งค่าโปรเจ็กต์ที่อยู่ในเครื่อง
ติดตั้ง CLI โดยทำตามวิธีการปกติ
จากนั้นเปิดใช้การทดสอบ Firebase Data Connect
firebase experiments:enable dataconnect
ในการตั้งค่าโปรเจ็กต์ภายในของคุณ เราจะเริ่มต้นไดเรกทอรีโปรเจ็กต์และอัปเดตไฟล์การกำหนดค่า 2-3 รายการที่จําเป็นสําหรับการสร้างโค้ด
ตั้งค่าไดเรกทอรีโปรเจ็กต์
เริ่มต้นไดเรกทอรีโปรเจ็กต์
การตั้งค่าส่วนขยาย Firebase
ในแผงด้านซ้ายมือของ VS Code ให้คลิกไอคอน Firebase เพื่อเปิด UI ส่วนขยายโค้ด Firebase VS
ใน UI ส่วนขยาย Firebase ให้ทำดังนี้
- ตรวจสอบว่าคุณได้ลงชื่อเข้าใช้แล้ว
- ในคอนโซล Firebase ให้ยืนยันว่าขั้นตอนการตั้งค่า Data Connect รวมถึงการจัดสรรฐานข้อมูลเสร็จสมบูรณ์แล้ว
- คลิกปุ่มเรียกใช้ Firebase Init
- ตรวจสอบแท็บ Terminal ในแผงด้านล่าง VS Code สำหรับข้อความแจ้ง
- เลือก Data Connect เป็นฟีเจอร์ที่จะใช้ในไดเรกทอรีนี้
- เมื่อได้รับข้อความแจ้ง ให้ระบุรหัสโปรเจ็กต์ บริการ และฐานข้อมูลของโปรเจ็กต์ Data Connect ที่คุณสร้างไว้ก่อนหน้านี้ในคอนโซล
การตั้งค่าเทอร์มินัล
- หากจำเป็น ให้ลงชื่อเข้าใช้ด้วย
firebase login
- ในคอนโซล Firebase ให้ยืนยันว่าขั้นตอนการตั้งค่า Data Connect รวมถึงการจัดสรรฐานข้อมูลเสร็จสมบูรณ์แล้ว
- เรียกใช้
firebase init
เพื่อเริ่มต้นไดเรกทอรีเป็นโปรเจ็กต์ Firebase ตามข้อความแจ้งบนหน้าจอ - เลือก Data Connect เป็นฟีเจอร์ที่จะใช้ในไดเรกทอรีนี้
- เมื่อได้รับข้อความแจ้ง ให้ระบุรหัสโปรเจ็กต์ บริการ และฐานข้อมูลของโปรเจ็กต์ Data Connect ที่คุณสร้างไว้ก่อนหน้านี้ในคอนโซล
ขั้นตอนใดก็ได้จะสร้างไฟล์ firebase.json
และ .firebaserc
และไดเรกทอรีย่อย dataconnect
รายการ ซึ่งรวมถึงไฟล์ dataconnect.yaml
และ connector.yaml
ที่สำคัญในไดเรกทอรีการทำงานในเครื่องของคุณ
กำหนดค่าตำแหน่งที่จะสร้างโค้ด SDK
Data Connect จะสร้างโค้ด SDK โดยอัตโนมัติขณะที่คุณแก้ไขสคีมา
หากต้องการระบุว่าจะสร้าง SDK ที่ไหน ให้อัปเดตไฟล์สำหรับเครื่องมือเชื่อมต่อเริ่มต้นใน dataconnect/connector/connector.yaml
connectorId: "my-connector"
authMode: "PUBLIC"
generate:
javascriptSdk:
outputDir: "../../js-email-generated"
package: "@email-manager/emails"
packageJsonDir: "../../"
kotlinSdk:
outputDir: "../kotlin-email-generated"
package: com.myemailapplication
ทำความคุ้นเคยกับ Data Connect Toolkit
ชุดเครื่องมือ Data Connect เป็นส่วนประกอบของส่วนขยาย Firebase VS Code ที่ช่วยในการพัฒนาสคีมา ตลอดจนการจัดการการค้นหาและเปลี่ยนแปลงโค้ดจาก Visual Studio Code โดยตรง
ในฟีเจอร์ชุดเครื่องมือ ให้ทำดังนี้
- เปิดไดเรกทอรีโปรเจ็กต์ Firebase ใน VS Code หากยังไม่ได้ดำเนินการ
- ใน VS Code ในแผงด้านซ้ายมือ ให้คลิกไอคอน Firebase เพื่อเปิด UI ของส่วนขยาย Firebase VS Code
ตลอดระยะเวลาการพัฒนา โปรดทราบว่าชุดเครื่องมือช่วยให้คุณโต้ตอบกับสภาพแวดล้อมเฉพาะที่ตลอดจนทรัพยากรที่ใช้งานจริงได้ ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะโต้ตอบกับสภาพแวดล้อมของเวอร์ชันที่ใช้งานจริง
UI ส่วนขยายมีฟีเจอร์ที่มีประโยชน์หลายอย่างให้คุณ
ในแถบข้างหลักของ VS:
- แผงการกำหนดค่าซึ่งช่วยให้คุณลงชื่อเข้าใช้ Google และเลือกโปรเจ็กต์ Firebase ได้
- แผง Firebase Data Connect ที่ให้คุณควบคุมโปรแกรมจำลองในตัวและทําให้ทรัพยากรใช้งานได้จริง
- แผง FDC Explorer จะแสดงรายการคำค้นหาโดยนัยและการกลายพันธุ์ที่สร้างขึ้นโดยอัตโนมัติตามสคีมา
ในแผงด้านล่างของ VS Code:
- แท็บการดำเนินการของ Data Connect ซึ่งมีเครื่องมือที่ช่วยให้คุณส่งข้อมูลในคำขอ เลียนแบบการตรวจสอบสิทธิ์ และดูผลลัพธ์ได้
ก่อนที่เราจะเริ่มพัฒนาแอป ลองมาดูคุณลักษณะบางส่วนของส่วนขยาย
ลองใช้ CodeLens ที่กำหนดเอง | เมื่อทำงานกับทรัพยากรในไฟล์ schema.gql , queries.gql และ mutations.gql เมื่อเขียนบล็อกโค้ดตามไวยากรณ์แล้ว CodeLens ที่กำหนดเองจะแสดงการดำเนินการที่คุณทำได้ในตารางและการดำเนินการที่ประกาศไว้
|
กำหนดระดับการตรวจสอบสิทธิ์สำหรับคำขอ | ในแผงด้านล่าง แผงการดำเนินการ Data Connect จะมีแท็บการกำหนดค่าให้คุณเลือกระดับการตรวจสอบสิทธิ์จำลองสำหรับการดำเนินการได้ |
เติมค่าตัวแปรในคำค้นหาและการเปลี่ยนแปลง | ในแท็บการกำหนดค่าเดียวกัน คุณสามารถป้อนข้อมูลเพย์โหลดการดำเนินการได้ |
ตรวจสอบประวัติ คำตอบ และข้อผิดพลาด | นอกจากนี้ คุณยังตรวจสอบแท็บ "ประวัติ" และ ผลลัพธ์เพื่อดูข้อมูลการแก้ไขข้อบกพร่องได้ในแท็บการกำหนดค่า |
สร้างสคีมาและการค้นหา Data Connect
การตั้งค่าเสร็จสมบูรณ์แล้ว ตอนนี้เราสามารถเริ่มพัฒนาด้วย Data Connect ได้แล้ว
เริ่มใช้ GraphQL เพื่อจำลองผู้ใช้และอีเมล คุณจะอัปเดตแหล่งที่มาใน
/dataconnect/schema/schema.gql
/dataconnect/connector/queries.gql
เริ่มพัฒนาสคีมา
ให้จดโฟลเดอร์ dataconnect
ในไดเรกทอรีโปรเจ็กต์ Firebase ซึ่งเป็นที่ที่คุณกำหนดโมเดลข้อมูลสำหรับฐานข้อมูล Cloud SQL โดยใช้ GraphQL
ในไฟล์ /dataconnect/schema/schema.gql
ให้เริ่มกำหนดสคีมาที่มีผู้ใช้และอีเมล
ผู้ใช้
ใน Data Connect จะมีการแมปช่อง GraphQL กับคอลัมน์ต่างๆ ผู้ใช้มี uid
, name
และอีเมล address
Data Connect จำแนกประเภทข้อมูลพื้นฐานได้หลายประเภท ได้แก่ String
และ Date
คัดลอกข้อมูลโค้ดต่อไปนี้หรือยกเลิกการแสดงความคิดเห็นในบรรทัดที่เกี่ยวข้องในไฟล์
# File `/dataconnect/schema/schema.gql`
type User @table(key: "uid") {
uid: String!
name: String!
address: String!
}
โดยค่าเริ่มต้น Firebase Data Connect จะเพิ่มคีย์ UUID id
หากยังไม่มี แต่ในกรณีนี้คุณต้องการให้ uid
ของฉันเป็นคีย์หลัก ซึ่งทำผ่านคำสั่ง @table(key: "uid")
ได้
อีเมล
เมื่อคุณมีผู้ใช้แล้ว คุณสามารถจำลองอีเมลได้ ในส่วนนี้ คุณจะเพิ่มช่อง (หรือคอลัมน์) ทั่วไปสำหรับข้อมูลอีเมลได้ ครั้งนี้เราจะไม่เพิ่มคีย์หลัก เพราะคุณใช้ Data Connect ในการจัดการได้
# File `/dataconnect/schema/schema.gql`
type Email @table {
subject: String!
date: Date!
text: String!
from: User!
}
สังเกตว่าฟิลด์ from
แมปกับประเภท User
แล้ว
Data Connect เข้าใจว่านี่คือความสัมพันธ์ระหว่าง Email
กับ User
และจะจัดการความสัมพันธ์นี้ให้คุณ
ทำให้สคีมาใช้งานได้จริง
เนื่องจากคุณใช้ส่วนขยาย Firebase VS Code เพื่อทำงานกับฐานข้อมูลที่ใช้งานจริง คุณจึงต้องทำให้สคีมาใช้งานได้ก่อนดำเนินการต่อ
- คุณสามารถใช้ส่วนขยาย Firebase VS Code เพื่อทำให้ใช้งานได้
- ใน UI ของส่วนขยายในแผง Firebase Data Connect ให้คลิกทำให้ใช้งานได้
หรือจะใช้ Firebase CLI ก็ได้
firebase deploy
ในกระบวนการของส่วนขยายหรือ CLI คุณอาจต้องตรวจสอบการเปลี่ยนแปลงสคีมาและอนุมัติการแก้ไขที่อาจเป็นอันตราย ระบบจะขอให้คุณดำเนินการดังนี้
- ตรวจสอบการเปลี่ยนแปลงสคีมาโดยใช้
firebase dataconnect:sql:diff
- เมื่อพอใจกับการเปลี่ยนแปลงแล้ว ให้นำการเปลี่ยนแปลงไปใช้โดยใช้ขั้นตอนที่
firebase dataconnect:sql:migrate
เริ่มต้น
- ตรวจสอบการเปลี่ยนแปลงสคีมาโดยใช้
ดูส่วนขยายสคีมาที่สร้างขึ้น
เมื่อคุณแก้ไขสคีมาอีเมล Data Connect จะสร้างส่วนขยายสคีมา การค้นหา การเปลี่ยนแปลง ตัวกรอง และความสัมพันธ์ของตารางโดยอัตโนมัติ คุณดูโค้ดที่สร้างขึ้นนี้ได้ 2 วิธี
- คุณดูรายการการค้นหาและการเปลี่ยนแปลงโดยนัยที่สร้างขึ้นได้ใน UI ของส่วนขยาย Firebase ใต้แผง FDC Explorer
- คุณดูโค้ดทั้งหมดที่สร้างขึ้นโดยในเครื่องได้ในแหล่งที่มาในไดเรกทอรี
.dataconnect/schema
ดำเนินการเปลี่ยนแปลงเพื่อเพิ่มข้อมูลลงในตาราง
คุณจะเห็นปุ่ม CodeLens ปรากฏในประเภท GraphQL ใน /dataconnect/schema/schema.gql
การค้นหาและการเปลี่ยนแปลงเวลาพัฒนา
การทำงานที่เชื่อมโยงกับปุ่ม CodeLens เหล่านี้เป็นการทำงานที่รวดเร็วและเป็นประโยชน์ ซึ่งในกรณีนี้จะเป็นการเพิ่มข้อมูลลงในตาราง Data Connect ใช้การกลายพันธุ์ GraphQL เพื่ออธิบายวิธีและผู้ที่มีสิทธิ์ดำเนินการกับฐานข้อมูล การใช้ปุ่มนี้จะสร้างการดำเนินการเวลาพัฒนาสำหรับการหมักข้อมูลอย่างรวดเร็ว
เมื่อคุณทำให้สคีมาเป็นเวอร์ชันที่ใช้งานจริงแล้ว คุณจะใช้ปุ่ม CodeLens เรียกใช้ (เวอร์ชันที่ใช้งานจริง) เพื่อดำเนินการเหล่านี้ได้ในแบ็กเอนด์
เขียนคำค้นหาเพื่อแสดงอีเมล
ทีนี้มาถึงส่วนที่สนุกแล้ว นั่นคือการค้นหา ในฐานะนักพัฒนาซอฟต์แวร์ คุณคุ้นเคยกับการเขียนคำค้นหา SQL มากกว่าการค้นหา GraphQL ดังนั้นจึงอาจรู้สึกแตกต่างไปเล็กน้อยในตอนแรก อย่างไรก็ตาม GraphQL มีความแม่นยําและเป็นประเภทปลอดภัยมากกว่า SQL ดิบ ส่วนส่วนขยาย VS Code ก็ช่วยลดความยุ่งยากในการพัฒนา
เริ่มแก้ไขไฟล์ /dataconnect/connector/queries.gql
หากต้องการรับอีเมลทั้งหมด
ให้ใช้คำค้นหาแบบนี้
# File `/dataconnect/connector/queries.gql`
query listEmails @auth(level: PUBLIC) {
emails {
id, subject, text, date
from {
name
}
}
}
คุณลักษณะที่น่าสนใจมากอย่างหนึ่งคือความสามารถในการจัดการความสัมพันธ์ของ
ฐานข้อมูลให้เหมือนกับกราฟ เนื่องจากอีเมลมีช่อง from
ที่อ้างอิงผู้ใช้ คุณจึงฝังข้อมูลในช่องนี้และรับข้อมูลผู้ใช้ได้
คำสั่ง @auth
คำสั่ง @auth
ไม่ได้ใช้อย่างเต็มศักยภาพในตัวอย่างนี้ แต่แนวคิดนั้นทรงพลังมาก นี่เป็นวิธีที่คุณเลือกนโยบายการให้สิทธิ์
สำหรับการดำเนินการกับฐานข้อมูล
การค้นหานี้ค่อนข้างตรงไปตรงมา ฟีเจอร์ที่น่าตื่นเต้นจริงๆ ของ Data Connect จะเริ่มโดดเด่นเมื่อคุณดำเนินการผนวกที่ซับซ้อนมากขึ้นที่มีความสัมพันธ์แบบหลายต่อหลายความสัมพันธ์ คุณจะดูข้อมูลเพิ่มเติมเกี่ยวกับเรื่องนี้ขณะดูเครื่องมือและเอกสารประกอบได้
ทดสอบการค้นหาของคุณ
ตอนนี้เราได้สร้างการสืบค้นข้อมูลนี้เรียบร้อยแล้ว ให้ตรวจสอบว่าการค้นหาทำงานหรือไม่ก่อนที่จะผสานรวมเข้ากับโค้ดไคลเอ็นต์ ประสบการณ์ส่วนหนึ่งของนักพัฒนาแอปสำหรับ Data Connect คือความสามารถในการทำซ้ำและทดสอบผลการค้นหาอย่างรวดเร็วด้วยแผงการดำเนินการของ Data Connect
คุณสามารถระบุอาร์กิวเมนต์ที่คำค้นหานี้ต้องการ จากนั้นคลิกปุ่ม CodeLens เหนือชื่อคำค้นหา คำสั่งนี้จะประมวลผลการค้นหาและแสดงผลลัพธ์ คุณจึงเห็นว่าการค้นหาทำงานได้ตามที่คาดไว้
สร้างโค้ด SDK ของไคลเอ็นต์และข้อมูลการค้นหาจากแอปไคลเอ็นต์
หากต้องการปิดวงจรการพัฒนา ให้ผสานรวมการค้นหานี้ลงในโค้ดไคลเอ็นต์
คุณสามารถเขียนไคลเอ็นต์เพื่อแสดงการเรียกคำค้นหาและการจัดการ การตอบกลับจากบริการ Data Connect
- ค้นหาแหล่งที่มาที่สร้างขึ้นโดยอัตโนมัติในตำแหน่งที่คุณระบุไว้ก่อนหน้านี้ในไฟล์
connector.yaml
เพิ่ม Firebase ในโปรเจ็กต์ ลงทะเบียนแอป แล้วติดตั้ง Firebase SDK หลักที่เกี่ยวข้อง ดังนี้
- สำหรับ JavaScript ให้ทำตามวิธีการเหล่านี้
- สำหรับ Kotlin ให้ทำตามวิธีการเหล่านี้
หากไม่ได้ใช้ IDX คุณสามารถตั้งค่าไคลเอ็นต์ที่เรียกใช้ได้จากบรรทัดคำสั่ง
JavaScript
สร้างไฟล์ต้นฉบับ clientTest.js
และคัดลอกโค้ดต่อไปนี้
const { initializeApp } = require("firebase/app"); const { connectDataConnectEmulator, getDataConnect, } = require("firebase/data-connect"); const { listEmails, connectorConfig } = require("@email-manager/emails"); // TODO: Replace the following with your app's Firebase project configuration const firebaseConfig = { //... }; const app = initializeApp(firebaseConfig); const dc = getDataConnect(app, connectorConfig); // Remove the following line to connect directly to production connectDataConnectEmulator(dc, "localhost", 9399); listEmails().then(res => { console.log(res.data.emails); process.exit(0); });
และคุณสามารถเรียกใช้ไคลเอ็นต์ของคุณได้
node clientTest.js
Kotlin Android
สร้างไฟล์ต้นฉบับ clientTest.kt
และคัดลอกโค้ดต่อไปนี้
class MainActivity : ComponentActivity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) lifecycleScope.launch { val connector = MyConnector.instance connector.dataConnect.useEmulator() // Remove to connect to production try { println(connector.listEmails.execute().data.emails) } catch (e: Throwable) { println("ERROR: $e") } } } }
จากนั้นให้ทำดังนี้
- เรียกใช้กิจกรรม
- ตรวจสอบเอาต์พุต Logcat ของ Android
นำต้นแบบที่เสร็จสมบูรณ์แล้วไปใช้จริง
คุณได้ทำตามขั้นตอนการทำซ้ำในการพัฒนาแล้ว ตอนนี้คุณทำให้สคีมา ข้อมูล การค้นหา และการกลายใช้งานได้ไปยังเซิร์ฟเวอร์ด้วย UI ของส่วนขยาย Firebase หรือ Firebase CLI เหมือนกับที่ทำสคีมาแล้ว
เมื่อทำให้ใช้งานได้แล้ว บริการ Data Connect ของคุณก็จะพร้อมประมวลผลการดำเนินการจากไคลเอ็นต์ ระบบจะอัปเดตอินสแตนซ์ Cloud SQL สำหรับ PostgreSQL ด้วยสคีมาและข้อมูลที่สร้างขึ้นและทำให้ใช้งานได้แล้ว
(ไม่บังคับ) ติดตั้ง PostgreSQL ในเครื่อง
การติดตั้ง PostgreSQL ในเครื่องและการผสานรวมกับโปรแกรมจำลองช่วยให้คุณสร้างต้นแบบในสภาพแวดล้อมการพัฒนาในเครื่องได้อย่างเต็มที่
คุณติดตั้งอินสแตนซ์ใหม่ของ PostgreSQL หรือใช้อินสแตนซ์ที่มีอยู่ได้
ติดตั้ง PostgreSQL
ติดตั้ง PostgreSQL เวอร์ชัน 15.x ตามวิธีการสำหรับแพลตฟอร์มของคุณ
- macOS ดาวน์โหลดและติดตั้ง Postgres.app
- Windows: ใช้โปรแกรมติดตั้ง EDB จากหน้าการดาวน์โหลด PostgreSQL
- Docker: ดึงและเรียกใช้
อิมเมจ
pgvector/pgvector:15
ซึ่งมาพร้อมการรองรับทั้ง PostgreSQL 15.x และเวกเตอร์ - Linux: เราขอแนะนำให้ใช้ Docker กับอิมเมจก่อนหน้า หรือคุณจะทำตามวิธีการทางเลือกสำหรับการกระจายยอดนิยมก็ได้
บันทึกชื่อโฮสต์ พอร์ต ชื่อผู้ใช้ และรหัสผ่าน รวมถึงเอาต์พุตพารามิเตอร์ที่เกี่ยวข้องระหว่างลำดับการติดตั้ง
หากต้องการเชื่อมต่อกับอินสแตนซ์ PostgreSQL โปรแกรมจำลองต้องมีสิ่งต่อไปนี้
- พารามิเตอร์การกำหนดค่าการตั้งค่าเหล่านี้
- ชื่อฐานข้อมูลจาก
dataconnect.yaml
และฐานข้อมูลที่มีชื่อที่สอดคล้องกันเริ่มต้นในอินสแตนซ์ในเครื่อง
อัปเดต .firebaserc
ด้วยสตริงการเชื่อมต่อ
ใช้รายละเอียดการกำหนดค่า PostgreSQL ในเครื่อง ซึ่งรวมถึงชื่อผู้ใช้และรหัสผ่าน PostgreSQL ในเครื่องเป็นสตริงการเชื่อมต่อเพื่อเพิ่มไปยังคีย์ต่อไปนี้ในไฟล์ .firebaserc
{
"projects": {},
...,
...,
"dataconnectEmulatorConfig": {
"postgres": {
"localConnectionString": "postgresql://postgresusername:postgrespassword@localhost:5432?sslmode=disable"
}}
}
เชื่อมต่อกับอินสแตนซ์ PostgreSQL ในเครื่อง
เมื่อกำหนดค่านี้เรียบร้อยแล้ว หากต้องการเชื่อมต่อกับฐานข้อมูลภายในเครื่อง ให้ทำดังนี้
- ใน VS Code ในแผงด้านซ้ายมือ ให้คลิกไอคอน Firebase เพื่อเปิด UI ของส่วนขยาย Firebase VS Code
- คลิกปุ่มเชื่อมต่อกับ PostgreSQL