在 Datastore 模式下使用 Firestore (Datastore)

Firestore 是 NoSQL 文件資料庫，專為自動調整資源配置、提供高效能，以及協助輕鬆開發應用程式而打造。這是 Datastore 的最新版本，相較於 Datastore，Cloud Firestore 有多項改良之處。由於 Firestore (Datastore 模式) 專為伺服器用途和 App Engine 最佳化，因此建議您針對主要由 App Engine 應用程式使用的資料庫，選擇 Datastore。原生模式的 Firestore 最適合用於行動應用程式和即時通知。如要進一步瞭解 Firestore 模式，請參閱選擇原生模式和 Datastore 模式。

本文說明如何使用 Cloud 用戶端程式庫，在 Datastore 模式資料庫中儲存及擷取資料。 您可以在 app.yaml 檔案中指定執行階段版本和作業系統，在任何支援的 Python 版本中使用本指南中的範例應用程式。

事前準備和設定

  • 設定環境和專案，瞭解如何在 App Engine 中建構應用程式。請記下並儲存您的專案 ID，因為您需要這些資訊才能執行本文說明的範例應用程式。

複製存放區

下載 (複製) 此範例：

  git clone https://github.com/GoogleCloudPlatform/python-docs-samples
  cd python-docs-samples/appengine/flexible/datastore

編輯專案設定並設定依附元件

在 requirements.txt 檔案中加入 google-cloud-datastore 程式庫。這是 Datastore 模式的用戶端程式庫。

Flask==3.0.3
google-cloud-datastore==2.20.2
gunicorn==23.0.0

應用程式程式碼

範例應用程式會記錄、擷取及顯示訪客 IP。您可以看到記錄項目是雙欄位類別，其中註明類型 visit，並使用 put 指令儲存於 Datastore 模式中。然後，系統會使用 query() 指令，以遞減順序擷取最近的十筆造訪記錄。

@app.route("/")
def index():
    ds = datastore.Client()

    user_ip = request.remote_addr

    # Keep only the first two octets of the IP address.
    if is_ipv6(user_ip):
        user_ip = ":".join(user_ip.split(":")[:2])
    else:
        user_ip = ".".join(user_ip.split(".")[:2])

    entity = datastore.Entity(key=ds.key("visit"))
    entity.update(
        {
            "user_ip": user_ip,
            "timestamp": datetime.datetime.now(tz=datetime.timezone.utc),
        }
    )

    ds.put(entity)
    query = ds.query(kind="visit", order=("-timestamp",))

    results = []
    for x in query.fetch(limit=10):
        try:
            results.append("Time: {timestamp} Addr: {user_ip}".format(**x))
        except KeyError:
            print("Error with result format, skipping entry.")

    output = "Last 10 visits:\n{}".format("\n".join(results))

    return output, 200, {"Content-Type": "text/plain; charset=utf-8"}

使用 index.yaml 檔案

範例應用程式會執行查詢。 更精細的 Datastore 模式查詢作業需要使用一或多個索引，因此您必須在與應用程式一併上傳的 index.yaml 檔案中指定這些索引。這個檔案可透過手動方式建立，或是在本機上測試應用程式時自動產生。

本機測試

如果需要在本機環境中開發及測試您的應用程式，可以使用 Datastore 模式模擬器。

瞭解詳情

如需 Datastore 模式的完整資訊，包括最佳化與相關概念，請參閱 Firestore (Datastore 模式) 說明文件。