取得或建立

在交易中取得或建立。

深入探索

如需包含這個程式碼範例的詳細說明文件，請參閱下列內容：

程式碼範例

C#

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 C# API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

Entity task;
using (var transaction = _db.BeginTransaction())
{
    task = transaction.Lookup(_sampleTask.Key);
    if (task == null)
    {
        transaction.Insert(_sampleTask);
        transaction.Commit();
    }
}

Go

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Go API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

_, err := client.RunInTransaction(ctx, func(tx *datastore.Transaction) error {
	var task Task
	if err := tx.Get(key, &task); err != datastore.ErrNoSuchEntity {
		return err
	}
	_, err := tx.Put(key, &Task{
		Category:    "Personal",
		Done:        false,
		Priority:    4,
		Description: "Learn Cloud Datastore",
	})
	return err
})

Java

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Java API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

Entity task;
Transaction txn = datastore.newTransaction();
try {
  task = txn.get(taskKey);
  if (task == null) {
    task = Entity.newBuilder(taskKey).build();
    txn.put(task);
    txn.commit();
  }
} finally {
  if (txn.isActive()) {
    txn.rollback();
  }
}

Node.js

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Node.js API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

async function getOrCreate(taskKey, taskData) {
  const taskEntity = {
    key: taskKey,
    data: taskData,
  };
  const transaction = datastore.transaction();

  try {
    await transaction.run();
    const [task] = await transaction.get(taskKey);
    if (task) {
      // The task entity already exists.
      await transaction.rollback();
    } else {
      // Create the task entity.
      transaction.save(taskEntity);
      await transaction.commit();
    }
    return taskEntity;
  } catch (err) {
    await transaction.rollback();
  }
}

PHP

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 PHP API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

$transaction = $datastore->transaction();
$entity = $transaction->lookup($task->key());
if ($entity === null) {
    $entity = $transaction->insert($task);
    $transaction->commit();
}

Python

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Python API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

from google.cloud import datastore

# For help authenticating your client, visit
# https://cloud.google.com/docs/authentication/getting-started
client = datastore.Client()

import datetime

with client.transaction():
    key = client.key(
        "Task", datetime.datetime.now(tz=datetime.timezone.utc).isoformat()
    )

    task = client.get(key)

    if not task:
        task = datastore.Entity(key)
        task.update({"description": "Example task"})
        client.put(task)

    return task

Ruby

如要瞭解如何安裝及使用 Datastore 模式的用戶端程式庫，請參閱這篇文章。 詳情請參閱 Datastore 模式 Ruby API 參考說明文件。

如要驗證 Datastore 模式，請設定應用程式預設憑證。 詳情請參閱「為本機開發環境設定驗證」。

task = nil
datastore.transaction do |tx|
  task = tx.find task_key
  if task.nil?
    task = datastore.entity task_key do |t|
      t["category"] = "Personal"
      t["done"] = false
      t["priority"] = 4
      t["description"] = "Learn Cloud Datastore"
    end
    tx.save task
  end
end

後續步驟

如要搜尋及篩選其他 Google Cloud 產品的程式碼範例，請參閱Google Cloud 範例瀏覽器。