Créer une instance de boutique en ligne

Pour configurer la livraison en ligne, vous devez d'abord créer une instance de magasin en ligne pour la livraison en ligne Bigtable ou la livraison en ligne optimisée. Pour comprendre les différences entre la livraison en ligne Bigtable et la livraison en ligne optimisée, consultez la section Types de livraison en ligne.

Notez que vous ne pouvez plus modifier le type de livraison en ligne après avoir choisi la livraison en ligne Bigtable ou la livraison en ligne optimisée lors de la création de votre magasin en ligne. Toutefois, vous pouvez modifier la configuration du point de terminaison de diffusion pour une instance de magasin en ligne créée pour la diffusion en ligne optimisée.

Après avoir créé le magasin en ligne, vous pouvez ajouter des vues de caractéristiques et les associer à des sources de données de caractéristiques dans BigQuery.

Créer un stockage en ligne pour la diffusion en ligne Bigtable.

Utilisez les exemples suivants pour créer une instance de magasin en ligne pour la livraison en ligne Bigtable avec autoscaling.

Console

Suivez les instructions ci-dessous pour créer une boutique en ligne pour la livraison en ligne Bigtable à l'aide de la console Google Cloud.

Dans la section "Vertex AI" de la console Google Cloud, accédez à la page Feature Store.

Accéder à la page Feature Store
Cliquez sur Magasin en ligne pour accéder à la section Magasin en ligne.
Cliquez sur Créer pour ouvrir la page Créer un magasin en ligne.
Indiquez le nom de la boutique en ligne.
Facultatif : Pour ajouter des étiquettes, cliquez sur Ajouter une étiquette, puis spécifiez son nom et sa valeur. Vous pouvez ajouter plusieurs étiquettes à une boutique en ligne.
Dans le champ Choisir une solution de stockage pour votre magasin en ligne, cliquez sur Bigtable.
Modifiez le nombre minimal de nœuds, le nombre maximal de nœuds et l'objectif d'utilisation du CPU, si nécessaire.
Cliquez sur Créer.

REST

Pour créer une ressource FeatureOnlineStore, envoyez une requête POST à l'aide de la méthode featureOnlineStores.create.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

LOCATION_ID: région dans laquelle vous souhaitez créer la boutique en ligne, telle que us-central1.
PROJECT_ID : ID de votre projet
FEATUREONLINESTORE_NAME: nom de la nouvelle instance de boutique en ligne.
BOOLEAN Facultatif : pour créer un magasin en ligne compatible avec la gestion des représentations vectorielles continues, saisissez true. La valeur par défaut est false.

Méthode HTTP et URL :

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corps JSON de la requête :

{
  "bigtable": {
    "auto_scaling": {
      "min_node_count": 1,
      "max_node_count": 3,
      "cpu_utilization_target": 50
    }
  }
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la CLI gcloud. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Créer un magasin en ligne pour la livraison en ligne optimisée

Lorsque vous utilisez la livraison en ligne optimisée, vous pouvez configurer le magasin en ligne pour diffuser des caractéristiques à partir d'un point de terminaison public ou d'un point de terminaison Private Service Connect dédié. Utilisez un point de terminaison Private Service Connect si vous souhaitez diffuser des caractéristiques au sein d'un réseau VPC, avec des latences inférieures à celles associées à un point de terminaison public.

Créer un magasin en ligne pour la diffusion en ligne optimisée à partir d'un point de terminaison public

Utilisez les exemples suivants pour créer une boutique en ligne pour la livraison en ligne optimisée à partir d'un point de terminaison public.

Console

Suivez les instructions ci-dessous pour créer une boutique en ligne pour la livraison en ligne optimisée à l'aide de la console Google Cloud.

Dans la section "Vertex AI" de la console Google Cloud, accédez à la page Feature Store.

Accéder à la page Feature Store
Cliquez sur Magasin en ligne pour accéder à la section Magasin en ligne.
Cliquez sur Créer pour ouvrir la page Créer un magasin en ligne.
Indiquez le nom de la boutique en ligne.
Facultatif : Pour ajouter des étiquettes, cliquez sur Ajouter une étiquette, puis spécifiez son nom et sa valeur. Vous pouvez ajouter plusieurs étiquettes à une boutique en ligne.
Dans le champ Choisir une solution de stockage pour votre magasin en ligne, cliquez sur Optimisé.
Cliquez sur Créer.

REST

Pour créer une instance de magasin en ligne, envoyez une requête POST à l'aide de la méthode featureOnlineStores.create.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

LOCATION_ID : région dans laquelle vous souhaitez créer l'instance FeatureOnlineStore, par exemple us-central1.
PROJECT_ID : ID de votre projet
FEATUREONLINESTORE_NAME : nom de la nouvelle instance FeatureOnlineStore.

Méthode HTTP et URL :

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corps JSON de la requête :

{
  "optimized": {}
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Créer un magasin en ligne pour la diffusion en ligne optimisée à partir d'un point de terminaison Private Service Connect

Utilisez l'exemple suivant pour créer un magasin en ligne pour la diffusion en ligne optimisée avec Private Service Connect.

REST

Pour créer une instance de magasin en ligne, envoyez une requête POST à l'aide de la méthode featureOnlineStores.create.

Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :

LOCATION_ID : région dans laquelle vous souhaitez créer l'instance FeatureOnlineStore, par exemple us-central1.
PROJECT_ID : ID de votre projet
FEATUREONLINESTORE_NAME : nom de la nouvelle instance FeatureOnlineStore.

Méthode HTTP et URL :

POST https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME

Corps JSON de la requête :

{
  "optimized": {},
  "dedicated_serving_endpoint": {
    "private_service_connect_config": {
      "enable_private_service_connect": true,
      "project_allowlist": ["PROJECT_NAME"]
    }
  }
}

Pour envoyer votre requête, choisissez l'une des options suivantes :

curl

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME"

PowerShell

Remarque : La commande suivante suppose que vous vous êtes connecté à la CLI gcloud avec votre compte utilisateur en exécutant la commande gcloud init ou gcloud auth login. Vous pouvez exécuter la commande gcloud auth list pour vérifier quel est le compte actuellement actif.

Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION_ID-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/featureOnlineStores?feature_online_store_id=FEATUREONLINESTORE_NAME" | Select-Object -Expand Content

Vous devriez recevoir une réponse JSON de ce type :

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION_ID/featureOnlineStores/FEATUREONLINESTORE_NAME/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.aiplatform.v1.CreateFeatureOnlineStoreOperationMetadata",
    "genericMetadata": {
      "createTime": "2023-09-18T17:49:23.847496Z",
      "updateTime": "2023-09-18T17:49:23.847496Z"
    }
  }
}

Étapes suivantes

Découvrez comment créer une vue de caractéristiques.
Découvrez comment mettre à jour une boutique en ligne.