เริ่มต้นใช้งาน Firebase Data Connect

ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะได้เรียนรู้วิธีต่อไปนี้

  • เพิ่ม Firebase Data Connect ลงในโปรเจ็กต์ Firebase
  • ตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์รวมถึงส่วนขยายโค้ด Visual Studio เพื่อทำงานกับอินสแตนซ์เวอร์ชันที่ใช้งานจริง
  • จากนั้นเราจะแสดงวิธีการต่อไปนี้
    • สร้างสคีมาโดยใช้ตัวอย่างแอปอีเมล
    • กำหนดการค้นหาและการเปลี่ยนแปลงสำหรับสคีมา
    • ใช้ SDK ที่สร้างขึ้นโดยอัตโนมัติในการเรียกใช้การค้นหาและการเปลี่ยนแปลงเหล่านี้จากไคลเอ็นต์
    • นำต้นแบบขั้นสุดท้ายไปใช้จริง

สิ่งที่ต้องดำเนินการก่อน

คุณต้องมีสิ่งต่อไปนี้เพื่อใช้การเริ่มต้นอย่างรวดเร็วนี้

เพิ่ม Data Connect ลงในโปรเจ็กต์และสร้างแหล่งข้อมูล

  1. สร้างโปรเจ็กต์ Firebase หากยังไม่ได้ทำ
    1. ในคอนโซล Firebase ให้คลิกเพิ่มโปรเจ็กต์ จากนั้นทำตามวิธีการบนหน้าจอ

  2. อัปเกรดโปรเจ็กต์เป็นแพ็กเกจ Blaze วิธีนี้ช่วยให้คุณสร้างอินสแตนซ์ Cloud SQL สำหรับ PostgreSQL ได้

  3. ไปที่ส่วน Data Connect ของคอนโซล Firebase และทำตามขั้นตอนการตั้งค่าผลิตภัณฑ์

  4. เลือกตำแหน่งสำหรับฐานข้อมูล CloudSQL สำหรับ PostgreSQL

  5. จดชื่อโปรเจ็กต์ บริการ และฐานข้อมูลเพื่อยืนยันในภายหลัง

  6. ทำตามขั้นตอนการตั้งค่าที่เหลือแล้วคลิกเสร็จสิ้น

เลือกและตั้งค่าสภาพแวดล้อมในการพัฒนาซอฟต์แวร์

เริ่มจาก 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 ที่จะมีให้บริการเร็วๆ นี้

  1. สร้างไดเรกทอรีใหม่สำหรับโปรเจ็กต์ในเครื่อง
  2. เปิด VS Code ในไดเรกทอรีใหม่
  3. ดาวน์โหลดส่วนขยายซึ่งรวมเป็นแพ็กเกจ VSIX จากพื้นที่เก็บข้อมูลของ Firebase
  4. ใน VS Code ให้เลือกส่วนขยายจากเมนูมุมมอง
  5. ในแถบชื่อแผงส่วนขยาย ให้คลิกไอคอนเมนู more_horiz จากนั้นทำตามวิธีติดตั้งจาก VSIX...

การพัฒนา IDX

IDX คือสภาพแวดล้อมที่ได้รับการเพิ่มประสิทธิภาพสำหรับการพัฒนาเว็บแอป หากคุณเป็นนักพัฒนาซอฟต์แวร์ Kotlin สำหรับ Android ให้ทำตามขั้นตอนในแท็บการพัฒนาโค้ด VS

วิธีตั้งค่าเทมเพลต Data Connect IDX

  1. เข้าถึงเทมเพลตที่เว็บไซต์ Project IDX
  2. ทำตามขั้นตอนการตั้งค่า

ตั้งค่าโปรเจ็กต์ที่อยู่ในเครื่อง

ติดตั้ง CLI โดยทำตามวิธีการปกติ

จากนั้นเปิดใช้การทดสอบ Firebase Data Connect

firebase experiments:enable dataconnect

ในการตั้งค่าโปรเจ็กต์ภายในของคุณ เราจะเริ่มต้นไดเรกทอรีโปรเจ็กต์และอัปเดตไฟล์การกำหนดค่า 2-3 รายการที่จําเป็นสําหรับการสร้างโค้ด

ตั้งค่าไดเรกทอรีโปรเจ็กต์

เริ่มต้นไดเรกทอรีโปรเจ็กต์

การตั้งค่าส่วนขยาย Firebase

ในแผงด้านซ้ายมือของ VS Code ให้คลิกไอคอน Firebase เพื่อเปิด UI ส่วนขยายโค้ด Firebase VS

ใน UI ส่วนขยาย Firebase ให้ทำดังนี้

  1. ตรวจสอบว่าคุณได้ลงชื่อเข้าใช้แล้ว
  2. ในคอนโซล Firebase ให้ยืนยันว่าขั้นตอนการตั้งค่า Data Connect รวมถึงการจัดสรรฐานข้อมูลเสร็จสมบูรณ์แล้ว
  3. คลิกปุ่มเรียกใช้ Firebase Init
  4. ตรวจสอบแท็บ Terminal ในแผงด้านล่าง VS Code สำหรับข้อความแจ้ง
  5. เลือก Data Connect เป็นฟีเจอร์ที่จะใช้ในไดเรกทอรีนี้
  6. เมื่อได้รับข้อความแจ้ง ให้ระบุรหัสโปรเจ็กต์ บริการ และฐานข้อมูลของโปรเจ็กต์ Data Connect ที่คุณสร้างไว้ก่อนหน้านี้ในคอนโซล

การตั้งค่าเทอร์มินัล

  1. หากจำเป็น ให้ลงชื่อเข้าใช้ด้วย firebase login
  2. ในคอนโซล Firebase ให้ยืนยันว่าขั้นตอนการตั้งค่า Data Connect รวมถึงการจัดสรรฐานข้อมูลเสร็จสมบูรณ์แล้ว
  3. เรียกใช้ firebase init เพื่อเริ่มต้นไดเรกทอรีเป็นโปรเจ็กต์ Firebase ตามข้อความแจ้งบนหน้าจอ
  4. เลือก Data Connect เป็นฟีเจอร์ที่จะใช้ในไดเรกทอรีนี้
  5. เมื่อได้รับข้อความแจ้ง ให้ระบุรหัสโปรเจ็กต์ บริการ และฐานข้อมูลของโปรเจ็กต์ 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 โดยตรง

ในฟีเจอร์ชุดเครื่องมือ ให้ทำดังนี้

  1. เปิดไดเรกทอรีโปรเจ็กต์ Firebase ใน VS Code หากยังไม่ได้ดำเนินการ
  2. ใน VS Code ในแผงด้านซ้ายมือ ให้คลิกไอคอน Firebase เพื่อเปิด UI ของส่วนขยาย Firebase VS Code

ตลอดระยะเวลาการพัฒนา โปรดทราบว่าชุดเครื่องมือช่วยให้คุณโต้ตอบกับสภาพแวดล้อมเฉพาะที่ตลอดจนทรัพยากรที่ใช้งานจริงได้ ในการเริ่มต้นอย่างรวดเร็วนี้ คุณจะโต้ตอบกับสภาพแวดล้อมของเวอร์ชันที่ใช้งานจริง

ส่วนขยายโค้ด VS สำหรับ Data Connect ใน IDX

UI ส่วนขยายมีฟีเจอร์ที่มีประโยชน์หลายอย่างให้คุณ

ในแถบข้างหลักของ VS:

  • แผงการกำหนดค่าซึ่งช่วยให้คุณลงชื่อเข้าใช้ Google และเลือกโปรเจ็กต์ Firebase ได้
  • แผง Firebase Data Connect ที่ให้คุณควบคุมโปรแกรมจำลองในตัวและทําให้ทรัพยากรใช้งานได้จริง
  • แผง FDC Explorer จะแสดงรายการคำค้นหาโดยนัยและการกลายพันธุ์ที่สร้างขึ้นโดยอัตโนมัติตามสคีมา
ในแผงด้านล่างของ VS Code:

  • แท็บการดำเนินการของ Data Connect ซึ่งมีเครื่องมือที่ช่วยให้คุณส่งข้อมูลในคำขอ เลียนแบบการตรวจสอบสิทธิ์ และดูผลลัพธ์ได้

ก่อนที่เราจะเริ่มพัฒนาแอป ลองมาดูคุณลักษณะบางส่วนของส่วนขยาย

ลองใช้ CodeLens ที่กำหนดเอง เมื่อทำงานกับทรัพยากรในไฟล์ schema.gql, queries.gql และ mutations.gql เมื่อเขียนบล็อกโค้ดตามไวยากรณ์แล้ว CodeLens ที่กำหนดเองจะแสดงการดำเนินการที่คุณทำได้ในตารางและการดำเนินการที่ประกาศไว้
  • สำหรับตาราง CodeLens จะช่วยคุณสร้างการเปลี่ยนแปลงเพื่อเพิ่มข้อมูลไปยังฐานข้อมูลแบ็กเอนด์
  • สำหรับการค้นหาและการเปลี่ยนแปลง 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 เพื่อทำงานกับฐานข้อมูลที่ใช้งานจริง คุณจึงต้องทำให้สคีมาใช้งานได้ก่อนดำเนินการต่อ

  1. คุณสามารถใช้ส่วนขยาย Firebase VS Code เพื่อทำให้ใช้งานได้
    • ใน UI ของส่วนขยายในแผง Firebase Data Connect ให้คลิกทำให้ใช้งานได้

  2. หรือจะใช้ Firebase CLI ก็ได้

    firebase deploy

  3. ในกระบวนการของส่วนขยายหรือ 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

  1. ค้นหาแหล่งที่มาที่สร้างขึ้นโดยอัตโนมัติในตำแหน่งที่คุณระบุไว้ก่อนหน้านี้ในไฟล์ connector.yaml

  2. เพิ่ม Firebase ในโปรเจ็กต์ ลงทะเบียนแอป แล้วติดตั้ง Firebase SDK หลักที่เกี่ยวข้อง ดังนี้

  3. หากไม่ได้ใช้ 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")
      }
    }
  }
}

จากนั้นให้ทำดังนี้

  1. เรียกใช้กิจกรรม
  2. ตรวจสอบเอาต์พุต Logcat ของ Android

นำต้นแบบที่เสร็จสมบูรณ์แล้วไปใช้จริง

คุณได้ทำตามขั้นตอนการทำซ้ำในการพัฒนาแล้ว ตอนนี้คุณทำให้สคีมา ข้อมูล การค้นหา และการกลายใช้งานได้ไปยังเซิร์ฟเวอร์ด้วย UI ของส่วนขยาย Firebase หรือ Firebase CLI เหมือนกับที่ทำสคีมาแล้ว

เมื่อทำให้ใช้งานได้แล้ว บริการ Data Connect ของคุณก็จะพร้อมประมวลผลการดำเนินการจากไคลเอ็นต์ ระบบจะอัปเดตอินสแตนซ์ Cloud SQL สำหรับ PostgreSQL ด้วยสคีมาและข้อมูลที่สร้างขึ้นและทำให้ใช้งานได้แล้ว

(ไม่บังคับ) ติดตั้ง PostgreSQL ในเครื่อง

การติดตั้ง PostgreSQL ในเครื่องและการผสานรวมกับโปรแกรมจำลองช่วยให้คุณสร้างต้นแบบในสภาพแวดล้อมการพัฒนาในเครื่องได้อย่างเต็มที่

คุณติดตั้งอินสแตนซ์ใหม่ของ PostgreSQL หรือใช้อินสแตนซ์ที่มีอยู่ได้

ติดตั้ง PostgreSQL

ติดตั้ง PostgreSQL เวอร์ชัน 15.x ตามวิธีการสำหรับแพลตฟอร์มของคุณ

บันทึกชื่อโฮสต์ พอร์ต ชื่อผู้ใช้ และรหัสผ่าน รวมถึงเอาต์พุตพารามิเตอร์ที่เกี่ยวข้องระหว่างลำดับการติดตั้ง

หากต้องการเชื่อมต่อกับอินสแตนซ์ PostgreSQL โปรแกรมจำลองต้องมีสิ่งต่อไปนี้

  • พารามิเตอร์การกำหนดค่าการตั้งค่าเหล่านี้
  • ชื่อฐานข้อมูลจาก dataconnect.yaml และฐานข้อมูลที่มีชื่อที่สอดคล้องกันเริ่มต้นในอินสแตนซ์ในเครื่อง

อัปเดต .firebaserc ด้วยสตริงการเชื่อมต่อ

ใช้รายละเอียดการกำหนดค่า PostgreSQL ในเครื่อง ซึ่งรวมถึงชื่อผู้ใช้และรหัสผ่าน PostgreSQL ในเครื่องเป็นสตริงการเชื่อมต่อเพื่อเพิ่มไปยังคีย์ต่อไปนี้ในไฟล์ .firebaserc

{
  "projects": {},
  ...,
  ...,
  "dataconnectEmulatorConfig": {
    "postgres": {
      "localConnectionString": "postgresql://postgresusername:postgrespassword@localhost:5432?sslmode=disable"
    }}
}

เชื่อมต่อกับอินสแตนซ์ PostgreSQL ในเครื่อง

เมื่อกำหนดค่านี้เรียบร้อยแล้ว หากต้องการเชื่อมต่อกับฐานข้อมูลภายในเครื่อง ให้ทำดังนี้

  1. ใน VS Code ในแผงด้านซ้ายมือ ให้คลิกไอคอน Firebase เพื่อเปิด UI ของส่วนขยาย Firebase VS Code
  2. คลิกปุ่มเชื่อมต่อกับ PostgreSQL

ขั้นตอนถัดไป