Gérer les aspects et enrichir les métadonnées

Les métadonnées sont essentielles pour organiser et comprendre vos composants de données. Par exemple, les secteurs réglementés doivent protéger les informations permettant d'identifier personnellement l'utilisateur, comme les noms, les adresses et les numéros d'identification officiels. Ces données peuvent se produire dans de nombreuses instances dans les systèmes de données distribués. Dataplex Universal Catalog peut vous aider à découvrir et à cataloguer rapidement vos composants de données distribués. Vous pouvez ensuite classer les données comme étant des informations permettant d'identifier personnellement l'utilisateur.

En enrichissant les entrées de données avec un contexte pertinent, vous pouvez rendre vos données plus faciles à découvrir et plus utiles. Dataplex Universal Catalog permet de fournir du contexte grâce aux éléments suivants :

• Type d'aspect : modèle JSON définissant les données associées. Par exemple, pour les informations de conformité, vous pouvez avoir une classification des informations permettant d'identifier personnellement l'utilisateur et la conformité au RGPD.
• Aspect : instance d'un type d'aspect. Par exemple, {"pii_classification": "confidential", "gdpr_compliant": true}. Vous pouvez appliquer un aspect à une table entière ou à une colonne de table individuelle.

Une fois les données classifiées, vous pouvez leur appliquer des règles de qualité ou d'accès.

Pour en savoir plus, consultez À propos de la gestion des métadonnées dans Dataplex Universal Catalog.

Conseil : Si vous utilisez les métadonnées Dataplex Universal Catalog pour la première fois, envisagez de suivre le guide de démarrage rapide Ajouter des métadonnées à une table BigQuery.

Aspects

Les aspects vous permettent de capturer les métadonnées dans les entrées pour fournir un contexte pertinent. Vous pouvez utiliser les aspects pour stocker :

• Métadonnées métier : informations qui fournissent un contexte métier, comme la classification des données.

• Métadonnées techniques : détails techniques sur le composant de données, par exemple son schéma.

• Métadonnées dérivées des données : informations générées à partir des données elles-mêmes, comme les statistiques d'une table BigQuery.

Les aspects sont considérés comme des parties de la ressource d'entrée et non comme des ressources distinctes. Lorsque vous modifiez un aspect, vous modifiez l'entrée qui le contient.

Vous pouvez spécifier des aspects au niveau de l'entrée pour décrire une entrée, ou au niveau de la colonne pour décrire une colonne dans une entrée.

Chaque aspect est une instance d'un type d'aspect. Un type d'aspect définit un modèle pour ses aspects. Chaque type d'aspect contient un ensemble de champs. Lorsque vous créez des aspects, vous devez fournir des valeurs pour ces champs.

Pour une entrée donnée, il ne peut y avoir qu'un seul aspect associé par type d'aspect. Vous pouvez associer plusieurs aspects aux colonnes d'entrée par type d'aspect.

Remarque : Il n'est pas possible de créer et d'utiliser des aspects dans des entrées où le type d'aspect et l'entrée correspondants se trouvent dans des organisations Google Cloud différentes.

Catégories d'aspects

Les aspects sont classés dans les catégories suivantes :

• Aspects requis : aspects obligatoires lors de la création d'une entrée. Ces aspects sont définis par le type d'entrée d'une entrée donnée. Toutes les entrées appartenant à un type d'entrée doivent toujours comporter tous les aspects requis définis par ce type d'entrée.

  Dataplex Universal Catalog gère les aspects requis (par exemple, le schéma) pour les entrées système.

  Veuillez noter les points suivants :

  • Vous ne pouvez associer des aspects requis qu'à des entrées, et non aux colonnes d'une entrée.

  • Vous ne pouvez pas supprimer les aspects obligatoires d'une entrée.

  • Vous pouvez lire les aspects requis des entrées système, mais vous ne pouvez pas les modifier.

  • Les aspects de données ne peuvent pas être des aspects requis.

• Aspects facultatifs : vous pouvez associer des aspects facultatifs à des entrées ou à des colonnes d'entrée. Vous pouvez renseigner les aspects facultatifs au moment de la création de l'entrée ou ultérieurement en la modifiant.

  Vous pouvez supprimer les aspects facultatifs une fois qu'ils ont été renseignés.

Aspects des données

Les aspects peuvent contenir des informations dérivées des données, telles que les résultats d'un profil de données ou des exemples de requêtes. Il s'agit des aspects des données.

Types d'aspects

Les types d'aspect sont des ressources réutilisables qui fournissent des modèles pour les aspects.

Catégories de types d'aspects

Les types d'aspects sont classés en types d'aspects personnalisés et système.

Types d'aspects personnalisés

Les types d'aspects que vous créez dans Dataplex Universal Catalog sont appelés types d'aspects personnalisés.

Les types d'aspect personnalisés peuvent être globaux ou régionaux. Vous pouvez créer des types d'aspect personnalisés dans une région spécifique (par exemple, us-central1) ou en tant que ressource global. L'emplacement d'un type d'aspect a un impact sur la portée de son applicabilité et détermine les entrées avec lesquelles il peut être utilisé :

• Types d'aspects globaux : ils peuvent être utilisés pour créer des aspects pour les entrées dans n'importe quelle région. Choisissez un type d'aspect global si vous devez appliquer la même structure aux entrées de plusieurs régions, car vous n'avez besoin de le définir qu'une seule fois. Étant donné que la définition d'un type d'aspect global est répliquée dans toutes les régions, cette option peut ne pas convenir si le schéma de type d'aspect lui-même contient des informations sensibles ou si une résidence stricte des données est requise pour tous les composants de métadonnées.
• Types d'aspect régionaux : ne peuvent être utilisés que pour créer des aspects pour les entrées qui se trouvent dans la même région que le type d'aspect. Par exemple, un type d'aspect créé dans us-central1 ne peut être utilisé qu'avec des entrées dans us-central1. Choisissez un emplacement régional si un type d'aspect n'est pertinent que pour les entrées d'une région spécifique, ou pour vous assurer que la définition du type d'aspect réside dans la région sélectionnée, ce qui peut vous aider à répondre aux exigences de conformité et de souveraineté des données. Si vous utilisez des types d'aspect régionaux, mais que vous avez besoin de la même structure dans plusieurs régions, vous devez créer et gérer des définitions de types d'aspect distinctes dans chaque région.

Pour en savoir plus, consultez Contraintes liées aux projets et aux zones géographiques.

Types d'aspects système

Les types d'aspects fournis, utilisés et gérés par Dataplex Universal Catalog sont appelés types d'aspects système. Les types d'aspect système sont toujours globaux et peuvent donc être utilisés dans n'importe quelle région. Les types d'aspect système sont stockés dans un projet géré par Google, dont le numéro est 655216118709. Exemple : projects/655216118709/locations/global/aspectTypes/schema.

Chaque type d'aspect et type d'entrée définis par le système possède ses propres autorisations IAM. Pour en savoir plus, consultez Autorisations IAM pour les types d'aspects et d'entrées système.

Les types d'aspects système sont également classés en deux catégories : réutilisables et restreints. Le tableau suivant décrit les catégories de types d'aspects système et la liste des types d'aspects fournis par Dataplex Universal Catalog pour chacune des catégories :

Catégorie du type d'aspect système	Description	Types d'aspects fournis par Dataplex Universal Catalog
Type d'aspect système réutilisable	Vous pouvez utiliser ces types d'aspect pour créer ou modifier des aspects.	contacts data-profile data-quality-scorecard generic overview schema usage
Type d'aspect système restreint	Dataplex Universal Catalog gère ces types d'aspects. Vous pouvez lire les aspects de ces types d'aspects, mais vous ne pouvez pas les créer ni les modifier.	y compris, mais sans s'y limiter : analytics-hub aspecttype-aspect bigquery-dataset bigquery-table cloudsql-database cloudsql-instance cloudsql-table entrygroup-aspect entrytype-aspect sensitive-data-protection-profile storage storage-bucket storage-folder

Avant de commencer

Avant de créer et de gérer des types et des aspects, effectuez les tâches décrites dans cette section.

Rôles requis

Pour obtenir les autorisations nécessaires pour créer et gérer des types et des aspects, demandez à votre administrateur de vous accorder les rôles IAM suivants sur la ressource :

• Ensemble complet d'autorisations sur les ressources de métadonnées dans Dataplex Universal Catalog, y compris les types d'aspects et les aspects de données : Administrateur de catalogue Dataplex (roles/dataplex.catalogAdmin)
• Créer et gérer des ressources de métadonnées dans Dataplex Universal Catalog, y compris les types d'aspects et les aspects de données : Éditeur de catalogue Dataplex (roles/dataplex.catalogEditor)
• Ensemble complet d'autorisations sur les types d'aspect personnalisés (à l'exception des autorisations permettant d'utiliser les types d'aspect pour créer ou modifier des entrées) : Propriétaire du type d'aspect Dataplex (roles/dataplex.aspectTypeOwner)
• Afficher les types d'aspects et les règles IAM qui leur sont associées : Lecteur de catalogue Dataplex (roles/dataplex.catalogViewer)
• Utiliser les types d'aspect pour créer et modifier des entrées avec les aspects correspondants : Utilisateur du type d'aspect Dataplex (roles/dataplex.aspectTypeUser)
• Ajouter des aspects de certains types d'aspects système, tels que schema, overview et contacts : Propriétaire des entrées et des liens d'entrée Dataplex (roles/dataplex.entryOwner)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Pour en savoir plus, consultez Rôles IAM Dataplex Universal Catalog.

Activer l'API

Activez l'API Dataplex dans votre projet Dataplex Universal Catalog.

Activer l'API

Créer un type d'aspect personnalisé

Console

1. Dans la console Google Cloud , accédez à la page Catalogue de Dataplex Universal Catalog.

Accéder au catalogue

1. Cliquez sur l'onglet Types d'aspects et modèles de tags > Personnalisé.

2. Cliquez sur Créer un type d'aspect.

3. Dans la fenêtre Créer un type d'aspect, saisissez les informations suivantes :

4. Facultatif : Dans le champ Nom à afficher, saisissez un nom pour le type d'aspect.

   1. Dans le champ ID du type d'aspect, saisissez un ID unique pour le type d'aspect.
   2. Facultatif : Dans le champ Description, saisissez une description du type d'aspect.
   3. Dans le champ Emplacement, sélectionnez un emplacement pour le type d'aspect. Vous ne pouvez pas modifier l'emplacement d'un type d'aspect après l'avoir créé. Pour comprendre l'impact du choix d'un emplacement global par rapport à un emplacement régional, consultez la section Types d'aspect personnalisés.

5. Facultatif : Définissez un modèle pour votre type d'aspect.

Dans la section Modèle, cliquez sur Ajouter un champ. Dans la section Nouveau champ, saisissez les informations suivantes :

1. Dans le champ Nom, saisissez un nom.

   1. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher.
   2. Facultatif : Dans le champ Description, saisissez une description.

   3. Dans le champ Type, sélectionnez un type de données pour le champ. En fonction de votre sélection, l'ensemble suivant de champs et d'options s'affiche :

              *   If you selected **Text** as the data type, follow
                  these steps:
      

2. Dans le champ Type de texte, sélectionnez le type de texte. 1. Dans le champ Valeurs de texte, fournissez un indice pour le champ de texte. Pour ce faire, cliquez sur Ajouter une valeur et saisissez l'indice. Vous pouvez ajouter plusieurs suggestions pour un champ de texte. 1. Cliquez sur OK.

               *   If you selected **Enum** as the data type, add an
                   enum value:
   

3. Cliquez sur Ajouter une valeur enum. 1. Dans le champ Valeur, saisissez une valeur d'énumération. Vous pouvez ajouter plusieurs valeurs d'énumération. 1. Cliquez sur OK.

               *   If you selected **Array** as the data type, in the
                   **Array item** section, define the types of items to
                   be present in the array:
   

4. Cliquez sur Ajouter un élément de tableau. 1. Dans le champ Nom, saisissez un nom pour les éléments du tableau. 1. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher pour les éléments du tableau. 1. Facultatif : Dans le champ Description, saisissez une description des éléments du tableau. 1. Dans le champ Type, sélectionnez un type de données pour les éléments du tableau.

En fonction de votre sélection, l'ensemble suivant de champs et d'options s'affiche. Elles sont semblables aux options décrites pour les types de données Text, Enum, Map, Array et Record ailleurs dans cette section.

1. Cliquez sur OK.

               *   If you selected **Map** as the data type, in the
                   **Map value** section, define the types of values to
                   be present in the map:
   

2. Cliquez sur Ajouter une valeur de mappage. 1. Dans le champ Nom, saisissez un nom pour la carte. 1. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher pour la carte. 1. Facultatif : Dans le champ Description, saisissez une description de la carte. 1. Dans le champ Type, sélectionnez un type de données pour la carte.

En fonction de votre sélection, l'ensemble suivant de champs et d'options s'affiche. Elles sont semblables aux options décrites pour les types de données Text, Enum, Map, Array et Record ailleurs dans cette section.

1. Cliquez sur OK.

               *   If you selected **Record** as the data type, enter
                   the following:
   

2. Dans le champ ID de l'enregistrement, saisissez un ID unique que les autres champs d'enregistrement pourront utiliser pour faire référence à cet enregistrement. Consultez la section Exemple d'utilisation des champs "ID de l'enregistrement" et "Référence de l'enregistrement" de ce document. 1. Facultatif : Si vous souhaitez ajouter une référence à un autre enregistrement de ce modèle, utilisez le champ Référence à un enregistrement. Vous ne pourrez pas modifier cette option après avoir créé le type d'aspect. Consultez la section Exemple d'utilisation des champs "ID de l'enregistrement" et "Référence de l'enregistrement" de ce document. 1. Dans la section Champs d'enregistrement, vous pouvez définir un objet complexe avec plusieurs champs imbriqués. Pour ce faire, cliquez sur Ajouter un élément de champ d'enregistrement, puis spécifiez les éléments suivants :

3. Dans le champ Nom, saisissez un nom pour le champ d'enregistrement. 1. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher pour le champ d'enregistrement. 1. Facultatif : Dans le champ Description, saisissez une description du champ d'enregistrement. 1. Dans le champ Type, sélectionnez un type de données.

En fonction de votre sélection, l'ensemble suivant de champs et d'options s'affiche. Elles sont semblables aux options décrites précédemment dans cette section pour les types de données Text, Enum, Map, Array et Record.

1. Cliquez sur OK.

2. Pour rendre le champ obligatoire pour un aspect de ce type, sélectionnez Obligatoire. Pour en savoir plus sur les aspects requis et facultatifs, consultez la section Catégories d'aspects de ce document.

   1. Cliquez sur OK.
   2. Pour ajouter plusieurs champs, cliquez sur Ajouter un champ et répétez les étapes précédentes.

3. Facultatif : Dans la section Libellés, ajoutez des libellés arbitraires sous forme de paires clé/valeur à vos ressources :

4. Cliquez sur Ajouter une étiquette.

   1. Dans le champ Clé, saisissez une clé.
   2. Dans le champ Valeur, saisissez une valeur pour la clé.
   3. Pour ajouter d'autres libellés, cliquez sur Ajouter un libellé et répétez la procédure.

5. Cliquez sur Enregistrer.

gcloud

Pour créer un type d'aspect personnalisé, utilisez la commande gcloud dataplex aspect-types create.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using Google.LongRunning;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for CreateAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void CreateAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        CreateAspectTypeRequest request = new CreateAspectTypeRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            AspectTypeId = "",
            AspectType = new AspectType(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<AspectType, OperationMetadata> response = catalogServiceClient.CreateAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<AspectType, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        AspectType result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<AspectType, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceCreateAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            AspectType retrievedResult = retrievedResponse.Result;
        }
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.CreateAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#CreateAspectTypeRequest.
	}
	op, err := c.CreateAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	resp, err := op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.CreateAspectTypeRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncCreateAspectType {

  public static void main(String[] args) throws Exception {
    syncCreateAspectType();
  }

  public static void syncCreateAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      CreateAspectTypeRequest request =
          CreateAspectTypeRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setAspectTypeId("aspectTypeId-423030675")
              .setAspectType(AspectType.newBuilder().build())
              .setValidateOnly(true)
              .build();
      AspectType response = catalogServiceClient.createAspectTypeAsync(request).get();
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_create_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    aspect_type = dataplex_v1.AspectType()
    aspect_type.metadata_template.name = "name_value"
    aspect_type.metadata_template.type_ = "type__value"

    request = dataplex_v1.CreateAspectTypeRequest(
        parent="parent_value",
        aspect_type_id="aspect_type_id_value",
        aspect_type=aspect_type,
    )

    # Make the request
    operation = client.create_aspect_type(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the create_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#create_aspect_type.
#
def create_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::CreateAspectTypeRequest.new

  # Call the create_aspect_type method.
  result = client.create_aspect_type request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

Pour créer un type d'aspect personnalisé, utilisez la méthode aspectType.create.

Une fois que vous avez créé un type d'aspect personnalisé, vous pouvez ajouter des aspects aux entrées.

Exemple d'utilisation des champs "ID d'enregistrement" et "Référence d'enregistrement"

Vous pouvez utiliser les champs ID de l'enregistrement et Référence de l'enregistrement pour les références récursives. L'exemple suivant montre comment utiliser ces champs :

Prenons l'exemple d'un type d'aspect appelé Employee, avec les champs suivants :

• Nom (type : Text)
• Date de début (type :Date & time)
• Désignation (type :Text)
• Adresse actuelle (type :Record)
• Adresse permanente (type :Record)

Les deux champs d'adresse Adresse actuelle et Adresse permanente sont du même type de données Record. Pour éviter les doublons, vous pouvez définir les valeurs ID de l'enregistrement et Référence de l'enregistrement lorsque vous définissez ces champs.

Lorsque vous définissez le champ Adresse actuelle, vous pouvez spécifier ID de l'enregistrement comme address-field. Pour Adresse permanente, vous pouvez spécifier la même valeur (address-field) pour Référence de l'enregistrement. Exemple :

• Nom (type : Text)
• Date de début (type :Date & time)
• Désignation (type :Text)
• Adresse actuelle (type :Record, ID d'enregistrement :address-field)
• Adresse permanente (type :Record, référence de l'enregistrement :address-field)

Vous n'avez ainsi pas besoin de dupliquer les champs d'une autre adresse.

Ajouter des aspects à une entrée

Une fois que vous avez créé un type d'aspect personnalisé, vous pouvez créer des aspects de ce type. Pour ajouter des aspects à une entrée, vous devez la mettre à jour, car les aspects sont stockés dans les entrées.

Veuillez noter les points suivants :

• Vous pouvez ajouter des aspects à une entrée ou aux colonnes d'une entrée.
• Vous ne pouvez modifier les aspects requis que pour les entrées personnalisées. Vous ne pouvez pas supprimer les aspects requis.
• Vous pouvez modifier et supprimer les aspects facultatifs pour les entrées personnalisées et système.

Remarque : Lorsque vous utilisez une instruction CREATE OR REPLACE TABLE pour remplacer une table BigQuery, les métadonnées (y compris les aspects) associées à la table d'origine ne sont pas appliquées à la nouvelle table. Si vous souhaitez que les métadonnées soient conservées, vous pouvez créer une vue BigQuery pour la table et y ajouter les métadonnées.

Console

1. Dans la console Google Cloud , accédez à la page Rechercher de Dataplex Universal Catalog.

Accéder à la recherche

1. Pour Choisir une plate-forme de recherche, sélectionnez Dataplex Universal Catalog comme mode de recherche.
2. Recherchez l'entrée à laquelle vous souhaitez ajouter des aspects, puis cliquez dessus. La page des détails de l'entrée s'ouvre.

3. Pour ajouter des aspects à l'entrée, procédez comme suit :

   1. Cliquez sur l'onglet Détails.
   2. Pour ajouter des aspects obligatoires ou facultatifs à l'entrée, dans la section Tags et aspects, cliquez sur Ajouter pour la catégorie correspondante.
       Vous ne pouvez pas ajouter d'aspects obligatoires si aucun aspect obligatoire n'a été défini pour le type d'entrée de l'entrée sélectionnée.
      
   3. Recherchez et sélectionnez l'aspect que vous souhaitez ajouter.
   4. Dans la fenêtre Ajouter un aspect, saisissez les valeurs des champs.

   5. Cliquez sur Enregistrer.

   6. Pour ajouter des aspects à une colonne de l'entrée, procédez comme suit :

   7. Sur la page des détails de l'entrée, cliquez sur l'onglet Schéma.

   8. Sélectionnez les colonnes auxquelles vous souhaitez ajouter des aspects.

   9. Cliquez sur Ajouter un aspect.

   10. Recherchez et sélectionnez l'aspect que vous souhaitez ajouter.

   11. Dans la fenêtre Ajouter un aspect, saisissez les valeurs des champs.

   12. Cliquez sur Enregistrer.

gcloud

Pour ajouter des aspects à une entrée ou à une colonne d'une entrée, utilisez la commande gcloud dataplex entries update.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Cloud.Dataplex.V1;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Pour ajouter des aspects à l'objet d'entrée, consultez Aspects.

Go

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Pour ajouter des aspects à l'objet d'entrée, consultez Entrée.

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.Aspect;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.EntryName;
import com.google.cloud.dataplex.v1.EntrySource;
import com.google.protobuf.FieldMask;
import com.google.protobuf.Struct;
import com.google.protobuf.Value;
import java.util.Map;

public class UpdateEntry {

  public static void main(String[] args) throws Exception {
    // TODO(developer): Replace these variables before running the sample.
    String projectId = "MY_PROJECT_ID";
    // Available locations: https://cloud.google.com/dataplex/docs/locations
    String location = "MY_LOCATION";
    String entryGroupId = "MY_ENTRY_GROUP_ID";
    String entryId = "MY_ENTRY_ID";

    Entry createdEntry = updateEntry(projectId, location, entryGroupId, entryId);
    System.out.println("Successfully updated entry: " + createdEntry.getName());
  }

  // Method to update Entry located in projectId, location, entryGroupId and with entryId
  public static Entry updateEntry(
      String projectId, String location, String entryGroupId, String entryId) throws Exception {
    // Initialize client that will be used to send requests. This client only needs to be created
    // once, and can be reused for multiple requests.
    try (CatalogServiceClient client = CatalogServiceClient.create()) {
      Entry entry =
          Entry.newBuilder()
              .setName(EntryName.of(projectId, location, entryGroupId, entryId).toString())
              .setEntrySource(
                  EntrySource.newBuilder()
                      .setDescription("updated description of the entry")
                      .build())
              .putAllAspects(
                  Map.of(
                      "dataplex-types.global.generic",
                      Aspect.newBuilder()
                          .setAspectType(
                              "projects/dataplex-types/locations/global/aspectTypes/generic")
                          .setData(
                              Struct.newBuilder()
                                  // "Generic" Aspect Type have fields called "type" and "system.
                                  // The values below are a sample of possible options.
                                  .putFields(
                                      "type",
                                      Value.newBuilder()
                                          .setStringValue("updated example value")
                                          .build())
                                  .putFields(
                                      "system",
                                      Value.newBuilder()
                                          .setStringValue("updated example system")
                                          .build())
                                  .build())
                          .build()))
              .build();

      // Update mask specifies which fields will be updated.
      // For more information on update masks, see: https://google.aip.dev/161
      FieldMask updateMask =
          FieldMask.newBuilder().addPaths("aspects").addPaths("entry_source.description").build();
      return client.updateEntry(entry, updateMask);
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

from google.cloud import dataplex_v1
from google.protobuf import struct_pb2


def update_entry(
    project_id: str, location: str, entry_group_id: str, entry_id: str
) -> dataplex_v1.Entry:
    """Method to update Entry located in project_id, location, entry_group_id and with entry_id"""

    # Initialize client that will be used to send requests across threads. This
    # client only needs to be created once, and can be reused for multiple requests.
    # After completing all of your requests, call the "__exit__()" method to safely
    # clean up any remaining background resources. Alternatively, use the client as
    # a context manager.
    with dataplex_v1.CatalogServiceClient() as client:
        # The resource name of the Entry
        name = f"projects/{project_id}/locations/{location}/entryGroups/{entry_group_id}/entries/{entry_id}"
        entry = dataplex_v1.Entry(
            name=name,
            entry_source=dataplex_v1.EntrySource(
                description="updated description of the entry"
            ),
            aspects={
                "dataplex-types.global.generic": dataplex_v1.Aspect(
                    aspect_type="projects/dataplex-types/locations/global/aspectTypes/generic",
                    data=struct_pb2.Struct(
                        fields={
                            # "Generic" Aspect Type have fields called "type" and "system.
                            # The values below are a sample of possible options.
                            "type": struct_pb2.Value(
                                string_value="updated example value"
                            ),
                            "system": struct_pb2.Value(
                                string_value="updated example system"
                            ),
                        }
                    ),
                )
            },
        )

        # Update mask specifies which fields will be updated.
        # For more information on update masks, see: https://google.aip.dev/161
        update_mask = {"paths": ["aspects", "entry_source.description"]}
        return client.update_entry(entry=entry, update_mask=update_mask)


if __name__ == "__main__":
    # TODO(developer): Replace these variables before running the sample.
    project_id = "MY_PROJECT_ID"
    # Available locations: https://cloud.google.com/dataplex/docs/locations
    location = "MY_LOCATION"
    entry_group_id = "MY_ENTRY_GROUP_ID"
    entry_id = "MY_ENTRY_ID"

    updated_entry = update_entry(project_id, location, entry_group_id, entry_id)
    print(f"Successfully updated entry: {updated_entry.name}")

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_entry call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateEntryRequest.new

  # Call the update_entry method.
  result = client.update_entry request

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

Pour ajouter des aspects à l'objet d'entrée, consultez #required_aspects=.

REST

Pour ajouter des aspects à une entrée ou à une colonne d'une entrée, utilisez la méthode entry.patch.

Il n'est pas possible de créer et d'utiliser des aspects dans une entrée lorsque le type d'aspect et l'entrée correspondants se trouvent dans des organisations Google Cloud différentes.

Associer des aspects de types d'aspect système réutilisables

Vous pouvez associer des aspects de types d'aspect système réutilisables à des entrées.

Vous pouvez modifier un aspect d'un type d'aspect réutilisable dans la console Google Cloud en fonction de sa structure. Les types d'aspect contenant des champs imbriqués ne peuvent pas être modifiés dans la console Google Cloud . Vous devez utiliser l'outil de ligne de commande gcloud ou l'API REST pour associer ou mettre à jour les aspects de ce type.

Tableau de données sur la qualité des données

Un tableau de données sur la qualité des données est un aspect qui fournit un récapitulatif de la qualité des données, souvent basé sur des analyses de la qualité des données ou d'autres processus. Vous pouvez associer un tableau de données sur la qualité des données à une entrée pour fournir des informations personnalisées sur la qualité des données. Pour ce faire, associez un aspect du type défini par le système data-quality-scorecard.

Le champ data de l'aspect data-quality-scorecard peut inclure les champs suivants :

• job : facultatif. Enregistrement contenant des informations sur le job qui a généré la fiche d'évaluation.

  • name : nom de ressource du job d'analyse de la qualité des données.

  • runTime : durée d'exécution du job de qualité des données.

• score : facultatif. Niveau de qualité global des données Le score est compris entre 0 et 100.

• status : valeur obligatoire. État de la fiche d'évaluation de la qualité des données, indiquant si elle a réussi ou échoué au seuil de qualité (PASS ou FAIL).

• dimensions : facultatif. Tableau de résultats de dimension. Chaque résultat inclut :

  • name : nom de la dimension. Il peut s'agir de ACCURACY, COMPLETENESS, CONSISTENCY, FRESHNESS, UNIQUENESS, VALIDITY ou VOLUME, ou d'un nom de dimension personnalisée. Les noms de dimensions personnalisées doivent être en majuscules et ne pas dépasser 30 caractères.

  • score : score global au niveau de la dimension, compris entre 0 et 100.

  • status : état de la dimension, indiquant si elle a dépassé ou non le seuil de qualité (PASS ou FAIL).

• columns : facultatif. Tableau de résultats de colonnes. Chaque résultat inclut :

  • name : nom de la colonne.

  • score : score global au niveau de la colonne, compris entre 0 et 100.

  • status : état de la colonne, indiquant si elle a réussi ou non à atteindre le seuil de qualité (PASS ou FAIL).

  • dimensions : tableau des scores de dimension pour la colonne. Chaque score de dimension inclut les éléments suivants :

    • name : nom de la dimension.

    • score : score de la dimension, compris entre 0 et 100.

    • status : état de la dimension pour la colonne, indiquant si elle a dépassé ou non le seuil de qualité (PASS ou FAIL).

Lorsque vous exécutez la commande pour associer un aspect, elle remplace toutes les données existantes pour cet aspect spécifique. Par exemple, si vous mettez à jour un tableau de données dont le score est 80 avec un nouveau fichier indiquant un score de 90, la valeur 80 est remplacée. Elle ne fusionne pas les données.

Pour joindre un tableau de données sur la qualité des données, procédez comme suit :

gcloud

Pour mettre à jour les aspects d'une entrée, utilisez la commande gcloud dataplex entries update-aspects.

1. Créez un fichier JSON (dq-aspect.json) avec le contenu suivant.

   Remarque : La clé de la carte d'aspect suit le format dataplex-types.global.<ASPECT-TYPE>.

     {
       "dataplex-types.global.data-quality-scorecard": {
         "data": {
           "score": 0.8,
           "status": "PASS",
           "dimensions": [
             {
               "name": "completeness",
               "score": 0.9,
               "status": "PASS"
             },
             {
               "name": "uniqueness",
               "score": 0.7,
               "status": "FAIL"
             }
           ],
           "columns": [
             {
               "name": "col1",
               "score": 0.85,
               "status": "PASS"
             }
           ]
         }
       }
     }
   }
   

2. Exécutez la commande suivante :

     gcloud dataplex entries update-aspects ENTRY_ID
     --location=LOCATION
     --entry-group=ENTRY_GROUP_ID
     --project=PROJECT_ID
     --aspects=dq-aspect.json
   

   Remplacez les variables suivantes :

   • ENTRY_ID : ID de l'entrée, par exemple example-entry
   • LOCATION : emplacement de l'entrée (par exemple, us-central1)
   • ENTRY_GROUP_ID : ID du groupe d'entrées (par exemple, example-entry-group)
   • PROJECT_ID : ID du projet, par exemple example-project

REST

Pour mettre à jour les aspects d'une entrée, utilisez la méthode entry.patch.

1. Créez un fichier nommé payload.json et collez-y le contenu JSON de votre requête.

   
     {
       "aspects": {
         "dataplex-types.global.data-quality-scorecard": {
           "aspectType": "projects/<var>PROJECT_ID</var>/locations/global/aspectTypes/data-quality-scorecard",
           "data": {
             "score": 80,
             "status": "PASS",
             "dimensions": [
               {
                 "name": "completeness",
                 "score": 90,
                 "status": "PASS"
               },
               {
                 "name": "uniqueness",
                 "score": 70,
                 "status": "FAIL"
               }
             ],
             "columns": [
               {
                 "name": "col1",
                 "score": 85,
                 "status": "PASS"
               }
             ]
           }
         }
       }
     }
   

2. Exécutez la commande suivante dans votre terminal :

    curl -X PATCH \
    -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    -d @payload.json \
    "https://dataplex.googleapis.com/v1/projects/<var>PROJECT_ID</var>/locations/<var>LOCATION</var>/entryGroups/<var>ENTRY_GROUP_ID</var>/entries/<var>ENTRY_ID</var>?updateMask=aspects"
   

   Remplacez les éléments suivants :

   • PROJECT_ID : ID du projet, par exemple example-project
   • LOCATION : emplacement de l'entrée (par exemple, us-central1)
   • ENTRY_GROUP_ID : ID du groupe d'entrées, par exemple example-entry-group
   • ENTRY_ID : ID de l'entrée, par exemple example-entry

Autres types d'aspect réutilisables

Les types d'aspect système suivants sont également disponibles. Vous pouvez les joindre à l'aide des mêmes méthodes gcloud ou API REST que celles présentées pour le tableau de données sur la qualité des données. Pour les types d'aspect sans champs imbriqués, par exemple generic, vous pouvez utiliser la console.

• Contacts. Utilisez le type d'aspect contacts pour attribuer la propriété ou la gestion. Les champs incluent les suivants :

  • identities (tableau) : liste de contacts. Chaque contact inclut les éléments suivants :
    • role (chaîne) : rôle du contact (par exemple, owner, steward, producer ou admin).
    • name (chaîne) : nom du contact.
    • id (chaîne) : adresse e-mail ou ID du contact.

  Créez le fichier payload.json comme suit :

   {
     "aspects": {
       "dataplex-types.global.contacts": {
         "data": {
           "identities": [
             {
               "role": "steward",
               "name": "Jane Doe",
               "id": "[e-mail]"
             }
           ]
         }
       }
     }
   }
  

• Profil de données. Utilisez le type d'aspect data-profile pour capturer les résultats du profilage des données. Pour en savoir plus, consultez À propos du profilage de données. Les champs incluent les suivants :

  • sourceDataInfo (enregistrement) : informations sur les données sources analysées pour générer le profil.
    • scope (énumération) : champ d'application du profil (PREVIEW, SAMPLED ou ALL).
    • scannedRows (int) : nombre de lignes analysées.
    • samplingPercentage (double) : pourcentage d'échantillonnage utilisé.
  • fields (map) : carte des noms de colonnes et de leurs profils de données, y compris des métriques telles que les valeurs uniqueness, nullness et topN, ainsi que des statistiques spécifiques au type pour les colonnes numeric, string, datetime et array.

  Créez le fichier payload.json comme suit :

   {
     "aspects": {
       "dataplex-types.global.data-profile": {
         "data": {
           "sourceDataInfo": {
           "scope": "ALL",
           "scannedRows": 100
         },
         "fields": {
           "col1": {
             "nullness": 0.0,
             "uniqueness": 0.1,
        "string": {
          "length": {
            "min": 1,
            "max": 20,
            "avg": 12.54
          }
        }
           }
         }
       }
     }
   }}
  

• Générique Utilisez le type d'aspect generic pour les informations génériques sur les entrées. Les champs incluent les suivants :

  • type (chaîne) : champ de forme libre permettant de stocker un type spécifié par l'utilisateur.
  • system (chaîne) : système de l'entrée personnalisée.

  Créez le fichier payload.json comme suit :

  {
    "aspects": {
      "dataplex-types.global.generic": {
        "data": {
          "type": "custom-type",
          "system": "custom-system"
        }
      }
    }
  }
  

• Présentation. Utilisez le type d'aspect overview pour fournir une description en texte enrichi. Les champs incluent les suivants :

  • content (chaîne) : aperçu de l'entrée, compatible avec le format HTML.
  • links (tableau) : liste des liens vers le système source. Chaque lien inclut les éléments suivants :
    • url (chaîne) : URL du lien.
    • title (chaîne) : titre du lien.

  Créez le fichier payload.json comme suit :

  {
    "aspects": {
      "dataplex-types.global.overview": {
        "data": {
          "content": "This is a <b>rich text</b> description.",
        "links": [
          {
            "url": "https://example.com",
            "title": "Example Link"
          }
        ]
      }
    }
  }}
  

• Schéma Utilisez le type d'aspect schema pour décrire la structure des données.

  • fields (tableau) : liste des champs de schéma. Les champs incluent les éléments suivants :
    • name (chaîne) : nom du champ.
    • dataType (chaîne) : type de données du champ.
    • metadataType (enum) : type de métadonnées (par exemple, STRING, BOOLEAN).
    • mode (énumération) : mode du champ (NULLABLE, REQUIRED, REPEATED).
    • description (chaîne) : description du champ.

  Créez le fichier payload.json comme suit :

  {
    "aspects": {
      "dataplex-types.global.schema": {
        "data": {
          "fields": [
          {
            "name": "id",
            "dataType": "string",
            "metadataType": "STRING",
            "mode": "REQUIRED"
          }
        ]
      }
    }
  }}
  

• Utilisation. Utilisez le type d'aspect usage pour suivre les métriques d'utilisation. Les champs incluent les suivants :

  • metrics (tableau) : liste des métriques d'utilisation. Chaque métrique inclut les éléments suivants :
    • name (chaîne) : nom de la métrique (par exemple, views, reads).
    • timeSeries (tableau) : liste de données de série temporelle. Chaque élément inclut les éléments suivants :
      • interval (chaîne) : intervalle d'agrégation (par exemple, 30d).
      • value (entier) : valeur agrégée.
  • refreshTime (datetime) : heure de la dernière actualisation des métriques.

  Créez le fichier payload.json comme suit :

  {
    "aspects": {
      "dataplex-types.global.usage": {
        "data": {
          "metrics": [
          {
            "name": "views",
            "timeSeries": [
              {
                "interval": "30d",
                "value": 100
              }
            ]
          }
        ],
        "refreshTime": "2025-01-01T12:00:00Z"
      }
    }
  }}
  

Gérer les aspects existants d'une entrée

Cette section explique comment mettre à jour et supprimer les aspects existants d'une entrée.

Modifier un aspect

Vous pouvez modifier les aspects facultatifs des entrées personnalisées et système. Vous ne pouvez modifier les aspects requis que pour les entrées personnalisées.

Console

1. Dans la console Google Cloud , accédez à la page Rechercher de Dataplex Universal Catalog.

Accéder à la recherche

1. Pour Choisir une plate-forme de recherche, sélectionnez Dataplex Universal Catalog comme mode de recherche.
2. Recherchez l'entrée dont vous souhaitez modifier les aspects, puis cliquez dessus.

La page des détails de l'entrée s'ouvre.

1.  Click the **Details** tab.

1. Dans la section Tags et aspects, développez l'aspect ou le tag que vous souhaitez modifier, puis cliquez sur Modifier.
2. Dans la fenêtre Modifier l'aspect, mettez à jour les champs obligatoires.
3. Cliquez sur Enregistrer.

gcloud

Pour mettre à jour les aspects d'une entrée ou d'une colonne d'une entrée, utilisez la commande gcloud dataplex entries update.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Cloud.Dataplex.V1;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.UpdateEntryRequest;
import com.google.protobuf.FieldMask;
import java.util.ArrayList;

public class SyncUpdateEntry {

  public static void main(String[] args) throws Exception {
    syncUpdateEntry();
  }

  public static void syncUpdateEntry() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryRequest request =
          UpdateEntryRequest.newBuilder()
              .setEntry(Entry.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setAllowMissing(true)
              .setDeleteMissingAspects(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      Entry response = catalogServiceClient.updateEntry(request);
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_entry():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry = dataplex_v1.Entry()
    entry.entry_type = "entry_type_value"

    request = dataplex_v1.UpdateEntryRequest(
        entry=entry,
    )

    # Make the request
    response = client.update_entry(request=request)

    # Handle the response
    print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_entry call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateEntryRequest.new

  # Call the update_entry method.
  result = client.update_entry request

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

REST

Pour mettre à jour les aspects d'une entrée ou d'une colonne d'une entrée, utilisez la méthode entry.patch.

Supprimer un aspect

Remarque Vous pouvez supprimer les aspects facultatifs d'une entrée, mais pas les aspects obligatoires.

Console

1. Dans la console Google Cloud , accédez à la page Rechercher de Dataplex Universal Catalog.

Accéder à la recherche

1. Pour Choisir une plate-forme de recherche, sélectionnez Dataplex Universal Catalog comme mode de recherche.
2. Recherchez l'entrée dont vous souhaitez supprimer les aspects, puis cliquez dessus.

La page des détails de l'entrée s'ouvre.

1.  Click the **Details** tab.

1. Dans la section Tags et aspects, développez l'aspect ou le tag que vous souhaitez supprimer, puis cliquez sur Supprimer.
2. Cliquez sur Confirmer.

gcloud

Pour supprimer un aspect d'une entrée, utilisez la commande gcloud dataplex entries update.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Cloud.Dataplex.V1;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateEntry</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateEntryRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateEntryRequest request = new UpdateEntryRequest
        {
            Entry = new Entry(),
            UpdateMask = new FieldMask(),
            AllowMissing = false,
            DeleteMissingAspects = false,
            AspectKeys = { "", },
        };
        // Make the request
        Entry response = catalogServiceClient.UpdateEntry(request);
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateEntryRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateEntryRequest.
	}
	resp, err := c.UpdateEntry(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.Entry;
import com.google.cloud.dataplex.v1.UpdateEntryRequest;
import com.google.protobuf.FieldMask;
import java.util.ArrayList;

public class SyncUpdateEntry {

  public static void main(String[] args) throws Exception {
    syncUpdateEntry();
  }

  public static void syncUpdateEntry() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateEntryRequest request =
          UpdateEntryRequest.newBuilder()
              .setEntry(Entry.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setAllowMissing(true)
              .setDeleteMissingAspects(true)
              .addAllAspectKeys(new ArrayList<String>())
              .build();
      Entry response = catalogServiceClient.updateEntry(request);
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_entry():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    entry = dataplex_v1.Entry()
    entry.entry_type = "entry_type_value"

    request = dataplex_v1.UpdateEntryRequest(
        entry=entry,
    )

    # Make the request
    response = client.update_entry(request=request)

    # Handle the response
    print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_entry call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_entry.
#
def update_entry
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateEntryRequest.new

  # Call the update_entry method.
  result = client.update_entry request

  # The returned object is of type Google::Cloud::Dataplex::V1::Entry.
  p result
end

REST

Pour supprimer un aspect d'une entrée, utilisez la méthode entry.patch.

Gérer les types d'aspects

Cette section explique comment afficher les types d'aspects, et comment mettre à jour et supprimer les types d'aspects personnalisés.

Remarque : Vous ne pouvez pas modifier ni supprimer les types d'aspect système, ni modifier leurs autorisations.

Afficher la liste des types d'aspects et des modèles de tags disponibles

Console

1. Dans la console Google Cloud , accédez à la page Catalogue de Dataplex Universal Catalog.

Accéder au catalogue

1. Cliquez sur l'onglet Types d'aspects et modèles de tags.

Cette page liste tous les types d'aspects Dataplex Universal Catalog et les modèles de tags Data Catalog disponibles.

1. Pour afficher les types d'aspects et les modèles de tags personnalisés, cliquez sur l'onglet Personnalisé. Dans l'onglet Personnalisé, la colonne Source du catalogue indique où se trouve la ressource (Dataplex Universal Catalog ou Data Catalog).

Pour afficher les types d'aspect système, cliquez sur l'onglet Système.

Pour en savoir plus sur les types d'aspects personnalisés et système, consultez la section Catégories de types d'aspects de ce document.

1. Facultatif : Pour afficher la liste des types d'aspects et des modèles de tags dans le projet sélectionné, cliquez sur l'onglet Personnalisé, puis désactivez l'option Afficher tous les projets.

L'option Afficher tous les projets est activée par défaut. La liste inclut les ressources Dataplex Universal Catalog de l'organisation que vous avez sélectionnée et les ressources Data Catalog de toutes les organisations auxquelles vous avez accès.

Remarque : Si l'option Afficher les données de tous les projets est activée, vous ne pouvez pas modifier ni supprimer directement un type d'aspect. Cliquez plutôt sur le type d'aspect pour ouvrir la page Détails du type d'aspect, puis modifiez-le ou supprimez-le.

gcloud

Pour lister tous les types d'aspects disponibles, utilisez la commande gcloud dataplex aspect-types list.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Api.Gax;
using Google.Api.Gax.ResourceNames;
using Google.Cloud.Dataplex.V1;
using System;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for ListAspectTypes</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void ListAspectTypesRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        ListAspectTypesRequest request = new ListAspectTypesRequest
        {
            ParentAsLocationName = LocationName.FromProjectLocation("[PROJECT]", "[LOCATION]"),
            Filter = "",
            OrderBy = "",
        };
        // Make the request
        PagedEnumerable<ListAspectTypesResponse, AspectType> response = catalogServiceClient.ListAspectTypes(request);

        // Iterate over all response items, lazily performing RPCs as required
        foreach (AspectType item in response)
        {
            // Do something with each item
            Console.WriteLine(item);
        }

        // Or iterate over pages (of server-defined size), performing one RPC per page
        foreach (ListAspectTypesResponse page in response.AsRawResponses())
        {
            // Do something with each page of items
            Console.WriteLine("A page of results:");
            foreach (AspectType item in page)
            {
                // Do something with each item
                Console.WriteLine(item);
            }
        }

        // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
        int pageSize = 10;
        Page<AspectType> singlePage = response.ReadPage(pageSize);
        // Do something with the page of items
        Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
        foreach (AspectType item in singlePage)
        {
            // Do something with each item
            Console.WriteLine(item);
        }
        // Store the pageToken, for when the next page is required.
        string nextPageToken = singlePage.NextPageToken;
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
	"google.golang.org/api/iterator"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.ListAspectTypesRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#ListAspectTypesRequest.
	}
	it := c.ListAspectTypes(ctx, req)
	for {
		resp, err := it.Next()
		if err == iterator.Done {
			break
		}
		if err != nil {
			// TODO: Handle error.
		}
		// TODO: Use resp.
		_ = resp

		// If you need to access the underlying RPC response,
		// you can do so by casting the `Response` as below.
		// Otherwise, remove this line. Only populated after
		// first call to Next(). Not safe for concurrent access.
		_ = it.Response.(*dataplexpb.ListAspectTypesResponse)
	}
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.ListAspectTypesRequest;
import com.google.cloud.dataplex.v1.LocationName;

public class SyncListAspectTypes {

  public static void main(String[] args) throws Exception {
    syncListAspectTypes();
  }

  public static void syncListAspectTypes() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      ListAspectTypesRequest request =
          ListAspectTypesRequest.newBuilder()
              .setParent(LocationName.of("[PROJECT]", "[LOCATION]").toString())
              .setPageSize(883849137)
              .setPageToken("pageToken873572522")
              .setFilter("filter-1274492040")
              .setOrderBy("orderBy-1207110587")
              .build();
      for (AspectType element : catalogServiceClient.listAspectTypes(request).iterateAll()) {
        // doThingsWith(element);
      }
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_list_aspect_types():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.ListAspectTypesRequest(
        parent="parent_value",
    )

    # Make the request
    page_result = client.list_aspect_types(request=request)

    # Handle the response
    for response in page_result:
        print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the list_aspect_types call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#list_aspect_types.
#
def list_aspect_types
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::ListAspectTypesRequest.new

  # Call the list_aspect_types method.
  result = client.list_aspect_types request

  # The returned object is of type Gapic::PagedEnumerable. You can iterate
  # over elements, and API calls will be issued to fetch pages as needed.
  result.each do |item|
    # Each element is of type ::Google::Cloud::Dataplex::V1::AspectType.
    p item
  end
end

REST

Pour lister tous les types d'aspects disponibles, utilisez la méthode aspectTypes.list.

Afficher les détails d'un type d'aspect ou d'un modèle de tag

Console

1. Dans la console Google Cloud , accédez à la page Catalogue de Dataplex Universal Catalog.

Accéder au catalogue

1. Cliquez sur l'onglet Types d'aspects et modèles de tags.

2. Pour afficher les détails d'un type d'aspect Dataplex Universal Catalog, cliquez sur le type d'aspect. La page de détails du type d'aspect s'ouvre. Vous y trouverez des informations telles que le nom à afficher, l'ID du type d'aspect, la description, l'ID du projet, l'emplacement, les libellés, la date de création et la date de la dernière modification.

   • Pour afficher la structure du type d'aspect sélectionné, cliquez sur l'onglet Modèle.
   • Pour afficher la liste des 10 entrées associées créées récemment, cliquez sur l'onglet Exemples d'entrées.
   • Pour rechercher toutes les entrées associées, cliquez sur Afficher toutes les entrées associées dans la recherche. Ce bouton n'apparaît que s'il existe au moins une entrée associée.

3. Pour afficher les détails d'un modèle de tag Data Catalog, cliquez dessus. La page d'informations sur le modèle de tag s'ouvre dans Data Catalog, où vous pouvez accéder à des informations telles que le nom à afficher, l'ID du modèle, l'ID du projet, l'emplacement, la visibilité et les libellés.

gcloud

Pour obtenir les détails d'un type d'aspect, utilisez la commande gcloud dataplex aspect-types describe.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Cloud.Dataplex.V1;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for GetAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void GetAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        GetAspectTypeRequest request = new GetAspectTypeRequest
        {
            AspectTypeName = AspectTypeName.FromProjectLocationAspectType("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]"),
        };
        // Make the request
        AspectType response = catalogServiceClient.GetAspectType(request);
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.GetAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#GetAspectTypeRequest.
	}
	resp, err := c.GetAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.AspectTypeName;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.GetAspectTypeRequest;

public class SyncGetAspectType {

  public static void main(String[] args) throws Exception {
    syncGetAspectType();
  }

  public static void syncGetAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      GetAspectTypeRequest request =
          GetAspectTypeRequest.newBuilder()
              .setName(AspectTypeName.of("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]").toString())
              .build();
      AspectType response = catalogServiceClient.getAspectType(request);
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_get_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.GetAspectTypeRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_aspect_type(request=request)

    # Handle the response
    print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the get_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#get_aspect_type.
#
def get_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::GetAspectTypeRequest.new

  # Call the get_aspect_type method.
  result = client.get_aspect_type request

  # The returned object is of type Google::Cloud::Dataplex::V1::AspectType.
  p result
end

REST

Pour obtenir les détails d'un type d'aspect, utilisez la méthode aspectTypes.get.

Modifier un type d'aspect personnalisé

Vous pouvez modifier le nom à afficher, la description, les champs de modèle et les libellés d'un type d'aspect personnalisé. Vous ne pouvez pas supprimer un champ existant dans un modèle.

Une fois le type d'aspect créé, vous ne pouvez plus modifier son ID ni son emplacement.

Console

1. Dans la console Google Cloud , accédez à la page Catalogue de Dataplex Universal Catalog.

Accéder au catalogue

1. Cliquez sur l'onglet Types d'aspects et modèles de tags.
2. Cliquez sur le type d'aspect que vous souhaitez modifier.
3. Sur la page Détails du type d'aspect, cliquez sur Modifier.
4. Modifiez le nom à afficher, la description, les champs du modèle et les libellés, si nécessaire.

5. Facultatif : Pour marquer un champ du type d'aspect comme obsolète, procédez comme suit :

   1. Dans la section Modèle, développez le champ.
   2. Sélectionnez Obsolète.
   3. Dans le champ Motif de l'abandon, saisissez un motif pour l'abandon du champ sélectionné.

   4. Cliquez sur OK.

   5. Cliquez sur Enregistrer.

gcloud

Pour mettre à jour un type d'aspect personnalisé, utilisez la commande gcloud dataplex aspect-types update.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Cloud.Dataplex.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for UpdateAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void UpdateAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        UpdateAspectTypeRequest request = new UpdateAspectTypeRequest
        {
            AspectType = new AspectType(),
            UpdateMask = new FieldMask(),
            ValidateOnly = false,
        };
        // Make the request
        Operation<AspectType, OperationMetadata> response = catalogServiceClient.UpdateAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<AspectType, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        AspectType result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<AspectType, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceUpdateAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            AspectType retrievedResult = retrievedResponse.Result;
        }
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.UpdateAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#UpdateAspectTypeRequest.
	}
	op, err := c.UpdateAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	resp, err := op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	// TODO: Use resp.
	_ = resp
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.AspectType;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.UpdateAspectTypeRequest;
import com.google.protobuf.FieldMask;

public class SyncUpdateAspectType {

  public static void main(String[] args) throws Exception {
    syncUpdateAspectType();
  }

  public static void syncUpdateAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      UpdateAspectTypeRequest request =
          UpdateAspectTypeRequest.newBuilder()
              .setAspectType(AspectType.newBuilder().build())
              .setUpdateMask(FieldMask.newBuilder().build())
              .setValidateOnly(true)
              .build();
      AspectType response = catalogServiceClient.updateAspectTypeAsync(request).get();
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_update_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    aspect_type = dataplex_v1.AspectType()
    aspect_type.metadata_template.name = "name_value"
    aspect_type.metadata_template.type_ = "type__value"

    request = dataplex_v1.UpdateAspectTypeRequest(
        aspect_type=aspect_type,
    )

    # Make the request
    operation = client.update_aspect_type(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the update_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#update_aspect_type.
#
def update_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::UpdateAspectTypeRequest.new

  # Call the update_aspect_type method.
  result = client.update_aspect_type request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

Pour mettre à jour un type d'aspect personnalisé, utilisez la méthode aspectTypes.patch.

Supprimer un type d'aspect personnalisé

Attention : La suppression d'un type d'aspect personnalisé entraîne la suppression de tous les aspects associés à ce type d'aspect.

Console

1. Dans la console Google Cloud , accédez à la page Catalogue de Dataplex Universal Catalog.

Accéder au catalogue

1. Cliquez sur l'onglet Types d'aspects et modèles de tags.
2. Cliquez sur le type d'aspect que vous souhaitez supprimer.
3. Sur la page Détails du type d'aspect, cliquez sur Supprimer. Confirmez l'opération lorsque vous y êtes invité.

gcloud

Pour supprimer un type d'aspect personnalisé, utilisez la commande gcloud dataplex aspect-types delete.

C#

C#

Avant d'essayer cet exemple, suivez les instructions de configuration pour C# décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour C#.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

using Google.Cloud.Dataplex.V1;
using Google.LongRunning;
using Google.Protobuf.WellKnownTypes;

public sealed partial class GeneratedCatalogServiceClientSnippets
{
    /// <summary>Snippet for DeleteAspectType</summary>
    /// <remarks>
    /// This snippet has been automatically generated and should be regarded as a code template only.
    /// It will require modifications to work:
    /// - It may require correct/in-range values for request initialization.
    /// - It may require specifying regional endpoints when creating the service client as shown in
    ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
    /// </remarks>
    public void DeleteAspectTypeRequestObject()
    {
        // Create client
        CatalogServiceClient catalogServiceClient = CatalogServiceClient.Create();
        // Initialize request argument(s)
        DeleteAspectTypeRequest request = new DeleteAspectTypeRequest
        {
            AspectTypeName = AspectTypeName.FromProjectLocationAspectType("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]"),
            Etag = "",
        };
        // Make the request
        Operation<Empty, OperationMetadata> response = catalogServiceClient.DeleteAspectType(request);

        // Poll until the returned long-running operation is complete
        Operation<Empty, OperationMetadata> completedResponse = response.PollUntilCompleted();
        // Retrieve the operation result
        Empty result = completedResponse.Result;

        // Or get the name of the operation
        string operationName = response.Name;
        // This name can be stored, then the long-running operation retrieved later by name
        Operation<Empty, OperationMetadata> retrievedResponse = catalogServiceClient.PollOnceDeleteAspectType(operationName);
        // Check if the retrieved long-running operation has completed
        if (retrievedResponse.IsCompleted)
        {
            // If it has completed, then access the result
            Empty retrievedResult = retrievedResponse.Result;
        }
    }
}

Accéder

Go

Avant d'essayer cet exemple, suivez les instructions de configuration pour Go décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Go.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

package main

import (
	"context"

	dataplex "cloud.google.com/go/dataplex/apiv1"
	dataplexpb "cloud.google.com/go/dataplex/apiv1/dataplexpb"
)

func main() {
	ctx := context.Background()
	// This snippet has been automatically generated and should be regarded as a code template only.
	// It will require modifications to work:
	// - It may require correct/in-range values for request initialization.
	// - It may require specifying regional endpoints when creating the service client as shown in:
	//   https://pkg.go.dev/cloud.google.com/go#hdr-Client_Options
	c, err := dataplex.NewCatalogClient(ctx)
	if err != nil {
		// TODO: Handle error.
	}
	defer c.Close()

	req := &dataplexpb.DeleteAspectTypeRequest{
		// TODO: Fill request struct fields.
		// See https://pkg.go.dev/cloud.google.com/go/dataplex/apiv1/dataplexpb#DeleteAspectTypeRequest.
	}
	op, err := c.DeleteAspectType(ctx, req)
	if err != nil {
		// TODO: Handle error.
	}

	err = op.Wait(ctx)
	if err != nil {
		// TODO: Handle error.
	}
}

Java

Java

Avant d'essayer cet exemple, suivez les instructions de configuration pour Java décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Java.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

import com.google.cloud.dataplex.v1.AspectTypeName;
import com.google.cloud.dataplex.v1.CatalogServiceClient;
import com.google.cloud.dataplex.v1.DeleteAspectTypeRequest;
import com.google.protobuf.Empty;

public class SyncDeleteAspectType {

  public static void main(String[] args) throws Exception {
    syncDeleteAspectType();
  }

  public static void syncDeleteAspectType() throws Exception {
    // This snippet has been automatically generated and should be regarded as a code template only.
    // It will require modifications to work:
    // - It may require correct/in-range values for request initialization.
    // - It may require specifying regional endpoints when creating the service client as shown in
    // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
    try (CatalogServiceClient catalogServiceClient = CatalogServiceClient.create()) {
      DeleteAspectTypeRequest request =
          DeleteAspectTypeRequest.newBuilder()
              .setName(AspectTypeName.of("[PROJECT]", "[LOCATION]", "[ASPECT_TYPE]").toString())
              .setEtag("etag3123477")
              .build();
      catalogServiceClient.deleteAspectTypeAsync(request).get();
    }
  }
}

Python

Python

Avant d'essayer cet exemple, suivez les instructions de configuration pour Python décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Python.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

# This snippet has been automatically generated and should be regarded as a
# code template only.
# It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
#   client as shown in:
#   https://googleapis.dev/python/google-api-core/latest/client_options.html
from google.cloud import dataplex_v1


def sample_delete_aspect_type():
    # Create a client
    client = dataplex_v1.CatalogServiceClient()

    # Initialize request argument(s)
    request = dataplex_v1.DeleteAspectTypeRequest(
        name="name_value",
    )

    # Make the request
    operation = client.delete_aspect_type(request=request)

    print("Waiting for operation to complete...")

    response = operation.result()

    # Handle the response
    print(response)

Ruby

Ruby

Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby décrites dans le guide de démarrage rapide de Dataplex Universal Catalog à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Dataplex Universal Catalog pour Ruby.

Pour vous authentifier auprès de Dataplex Universal Catalog, configurez le service Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.

require "google/cloud/dataplex/v1"

##
# Snippet for the delete_aspect_type call in the CatalogService service
#
# This snippet has been automatically generated and should be regarded as a code
# template only. It will require modifications to work:
# - It may require correct/in-range values for request initialization.
# - It may require specifying regional endpoints when creating the service
# client as shown in https://cloud.google.com/ruby/docs/reference.
#
# This is an auto-generated example demonstrating basic usage of
# Google::Cloud::Dataplex::V1::CatalogService::Client#delete_aspect_type.
#
def delete_aspect_type
  # Create a client object. The client can be reused for multiple calls.
  client = Google::Cloud::Dataplex::V1::CatalogService::Client.new

  # Create a request. To set request fields, pass in keyword arguments.
  request = Google::Cloud::Dataplex::V1::DeleteAspectTypeRequest.new

  # Call the delete_aspect_type method.
  result = client.delete_aspect_type request

  # The returned object is of type Gapic::Operation. You can use it to
  # check the status of an operation, cancel it, or wait for results.
  # Here is how to wait for a response.
  result.wait_until_done! timeout: 60
  if result.response?
    p result.response
  else
    puts "No response received."
  end
end

REST

Pour supprimer un type d'aspect personnalisé existant, utilisez la méthode aspectTypes.delete.

Étapes suivantes

• Découvrez comment rechercher des éléments de données dans Dataplex Universal Catalog.
• Découvrez comment gérer les entrées et ingérer des sources personnalisées.
• Découvrez comment importer des métadonnées dans Dataplex Universal Catalog.
• En savoir plus sur la gestion des métadonnées dans Dataplex Universal Catalog
• En savoir plus sur la transition de Data Catalog vers Dataplex Universal Catalog
• Suivez un atelier de programmation sur les principes de base de la gouvernance avec Dataplex Universal Catalog.