Cette page a été traduite par l'API Cloud Translation.

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 à un tableau entier ou à une colonne de tableau 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.

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é à l'entrée, par type d'aspect. Vous pouvez associer plusieurs aspects aux colonnes d'entrée par type d'aspect.

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 un emplacement régional spécifique (par exemple, us-central1) ou en tant que ressource global. L'emplacement d'un type d'aspect a une incidence sur le champ d'application 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 la 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 au projet et à l'emplacement.

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.

Les types d'aspects système sont également classés dans les 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 que Dataplex Universal Catalog fournit 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-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 de 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

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

Accéder au catalogue
Cliquez sur l'onglet Types d'aspects et modèles de tags > Personnalisé.
Cliquez sur Créer un type d'aspect.
Dans la fenêtre Créer un type d'aspect, saisissez les informations suivantes :
1. Facultatif : Dans le champ Nom à afficher, saisissez un nom pour le type d'aspect.
2. Dans le champ ID du type d'aspect, saisissez un ID unique pour le type d'aspect.
3. Facultatif : Dans le champ Description, saisissez une description du type d'aspect.
4. 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.
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.
2. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher.
3. Facultatif : Dans le champ Description, saisissez une description.
4. Dans le champ Type, sélectionnez un type de données pour le champ. En fonction de votre sélection, l'ensemble de champs et d'options suivant s'affiche :
  - Si vous avez sélectionné Texte comme type de données, procédez comme suit :
    1. Dans le champ Type de texte, sélectionnez le type de texte.
    2. 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.
    3. Cliquez sur OK.
  - Si vous avez sélectionné Enum comme type de données, ajoutez une valeur enum :
    1. Cliquez sur Ajouter une valeur enum.
    2. Dans le champ Valeur, saisissez une valeur d'énumération. Vous pouvez ajouter plusieurs valeurs enum.
    3. Cliquez sur OK.
  - Si vous avez sélectionné Tableau comme type de données, dans la section Élément de tableau, définissez les types d'éléments à inclure dans le tableau :
    1. Cliquez sur Ajouter un élément de tableau.
    2. Dans le champ Nom, saisissez un nom pour les éléments du tableau.
    3. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher pour les éléments du tableau.
    4. Facultatif : Dans le champ Description, saisissez une description des éléments du tableau.
    5. 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 Texte, Énumération, Map, Array et Record ailleurs dans cette section.
    6. Cliquez sur OK.
  - Si vous avez sélectionné Map comme type de données, dans la section Valeur de mappage, définissez les types de valeurs à inclure dans le mappage :
    1. Cliquez sur Ajouter une valeur de mappage.
    2. Dans le champ Nom, saisissez un nom pour la carte.
    3. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher pour la carte.
    4. Facultatif : Dans le champ Description, saisissez une description de la carte.
    5. 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 Texte, Énumération, Map, Array et Record ailleurs dans cette section.
    6. Cliquez sur OK.
  - Si vous avez sélectionné Enregistrement comme type de données, saisissez les informations suivantes :
    1. 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.
    2. 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.
    3. 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 :
    4. Dans le champ Nom, saisissez un nom pour le champ d'enregistrement.
    5. Facultatif : Dans le champ Nom à afficher, saisissez un nom à afficher pour le champ d'enregistrement.
    6. Facultatif : Dans le champ Description, saisissez une description du champ d'enregistrement.
    7. 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.
    8. Cliquez sur OK.
5. 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.
6. Cliquez sur OK.
7. Pour ajouter plusieurs champs, cliquez sur Ajouter un champ et répétez les étapes précédentes.
Facultatif : Dans la section Libellés, ajoutez des libellés arbitraires sous forme de paires clé/valeur à vos ressources :
1. Cliquez sur Ajouter une étiquette.
2. Dans le champ Clé, saisissez une clé.
3. Dans le champ Valeur, saisissez une valeur pour la clé.
4. Pour ajouter d'autres libellés, cliquez sur Ajouter un libellé et répétez la procédure.
Cliquez sur Enregistrer.

gcloud

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

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.


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

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.

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

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.

# 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

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.

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

Après avoir créé un type d'aspect, 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.

Console

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

Accéder à la recherche
Pour Choisir une plate-forme de recherche, sélectionnez Dataplex Universal Catalog comme mode de recherche.
Recherchez l'entrée à laquelle vous souhaitez ajouter des aspects, puis cliquez dessus. La page des détails de l'entrée s'ouvre.
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 requis si le type d'entrée de l'entrée sélectionnée n'en comporte aucun.
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.
Pour ajouter des aspects à une colonne de l'entrée, procédez comme suit :
1. Sur la page des détails de l'entrée, cliquez sur l'onglet Schéma.
2. Sélectionnez les colonnes auxquelles vous souhaitez ajouter des aspects.
3. Cliquez sur Ajouter un aspect.
4. Recherchez et sélectionnez l'aspect que vous souhaitez ajouter.
5. Dans la fenêtre Ajouter un aspect, saisissez les valeurs des champs.
6. 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#

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


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

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

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

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.

Gérer les aspects existants pour une entrée

Cette section explique comment modifier 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

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

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

La page des détails de l'entrée s'ouvre.
Cliquez sur l'onglet Détails.
Dans la section Tags et aspects, développez l'aspect ou le tag que vous souhaitez modifier, puis cliquez sur Modifier.
Dans la fenêtre Modifier l'aspect, mettez à jour les champs obligatoires.
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#

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


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

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

# 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

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

Console

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

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

La page des détails de l'entrée s'ouvre.
Cliquez sur l'onglet Détails.
Dans la section Tags et aspects, développez l'aspect ou le tag que vous souhaitez supprimer, puis cliquez sur Supprimer.
Cliquez sur Confirmer.

gcloud

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

C#

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


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

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

# 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

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, modifier et supprimer des types d'aspects.

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

Console

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

Accéder au catalogue
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.
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.
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 répertorier tous les types d'aspects disponibles, utilisez la commande gcloud dataplex aspect-types list.

C#

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


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

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

# 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

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

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

Accéder au catalogue
Cliquez sur l'onglet Types d'aspects et modèles de tags.
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 pouvez y accéder à 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 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.
Pour afficher les détails d'un modèle de tag Data Catalog, cliquez sur le modèle de tag. 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#

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


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

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

# 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

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

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

Accéder au catalogue
Cliquez sur l'onglet Types d'aspects et modèles de tags.
Cliquez sur le type d'aspect que vous souhaitez modifier.
Sur la page Détails du type d'aspect, cliquez sur Modifier.
Modifiez le nom à afficher, la description, les champs du modèle et les libellés, si nécessaire.
Facultatif : Pour marquer un champ du type d'aspect comme obsolète :
1. Dans la section Modèle, développez le champ.
2. Sélectionnez Obsolète.
3. Dans le champ Motif de l'abandon, saisissez le motif de l'abandon du champ sélectionné.
4. Cliquez sur OK.
Cliquez sur Enregistrer.

gcloud

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

C#

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


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

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

# 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

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é

Console

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

Accéder au catalogue
Cliquez sur l'onglet Types d'aspects et modèles de tags.
Cliquez sur le type d'aspect que vous souhaitez supprimer.
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#

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


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

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

# 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

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.
Apprenez à 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
Apprenez-en plus sur la transition depuis Data Catalog vers Dataplex Universal Catalog
Suivez un atelier de programmation sur la gouvernance de base avec Dataplex Universal Catalog.

Gérer les aspects et enrichir les métadonnées Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Aspects

Catégories d'aspects

Aspects des données

Types d'aspects

Catégories de types d'aspects

Types d'aspects personnalisés

Types d'aspects système

Avant de commencer

Rôles requis

Activer l'API

Créer un type d'aspect personnalisé

Console

gcloud

C#

C#

Accéder

Go

Java

Java

Python

Python

Ruby

Ruby

REST

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

Ajouter des aspects à une entrée

Console

gcloud

C#

C#

Go

Go

Java

Java

Python

Python

Ruby

Ruby

REST

Gérer les aspects existants pour une entrée

Modifier un aspect

Console

gcloud

C#

C#

Accéder

Go

Java

Java

Python

Python

Ruby

Ruby

REST

Supprimer un aspect

Console

gcloud

C#

C#

Accéder

Go

Java

Java

Python

Python

Ruby

Ruby

REST

Gérer les types d'aspects

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

Console

gcloud

C#

C#

Accéder

Go

Java

Java

Python

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