REST Resource: deltasharing.v1.projects.catalogs

Ressource : DeltaSharingCatalog

Représente un catalogue Delta Sharing.

Représentation JSON 
{
  "name": string,
  "location": string,
  "createTime": string,
  "updateTime": string,
  "serviceAccount": string,
  "refreshOptions": {
    object (RefreshOptions)
  },
  "refreshStatus": {
    object (RefreshStatus)
  },
  "federatedCatalogOptions": {
    object (FederatedCatalogOptions)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "sapConfig": {
    object (SapConfig)
  }
  // End of mutually exclusive fields.
  "encryptionConfig": {
    object (EncryptionConfig)
  }
}
Champs
name

string

Identifiant. Nom de la ressource. Format : projects/{project}/catalogs/{catalog}
location

string

Obligatoire. Immuable. Emplacement GCP du catalogue fourni par l'utilisateur. Ce champ n'est pas modifiable.
createTime

string (Timestamp format)

Uniquement en sortie. Heure de création du catalogue.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Uniquement en sortie. Heure de la dernière modification du catalogue.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
serviceAccount

string

Uniquement en sortie. Le compte de service utilisé pour l'enregistrement SAP est créé comme un effet secondaire de la création de la ressource de catalogue Delta Sharing.
refreshOptions

object (RefreshOptions)

Facultatif. Configure les options d'actualisation d'un catalogue Delta Sharing.
refreshStatus

object (RefreshStatus)

Uniquement en sortie. État de l'actualisation du catalogue en arrière-plan.
federatedCatalogOptions

object (FederatedCatalogOptions)

Facultatif. Options de configuration pour les catalogues fédérés.
Configuration du catalogue. Un seul champ doit être défini, ce qui détermine le type de catalogue. Vous trouverez ci-dessous la liste des champs mutuellement exclusifs. Au maximum, un seul des champs sera défini dans une réponse :
sapConfig

object (SapConfig)

Facultatif. Configuration d'un catalogue qui se connecte à SAP Business Data Cloud (BDC).
Fin des champs qui s'excluent mutuellement.
encryptionConfig

object (EncryptionConfig)

Facultatif. Configuration de chiffrement personnalisée (par exemple, clés Cloud KMS).

SapConfig

Configuration pour SAP Business Data Cloud (BDC).

Représentation JSON 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
Champs
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

Facultatif. Pour créer une ressource de catalogue qui se connecte à SAP BDC, suivez ces trois étapes : Définissez SapConfig sur "empty" (vide). Cela crée une ressource de catalogue avec un compte de service GCP : serviceAccount. 2. Sur votre instance SAP BDC, à l'aide de ce serviceAccount, suivez la procédure d'enregistrement et créez un connecteur BDC. Vous recevrez connectorEndpoint et invitationCode de la part de SAP. 3. À l'aide de ces champs supplémentaires fournis par SAP, mettez à jour la ressource de catalogue BigLake créée précédemment avec SapBdcEnrollmentConfig. Une fois le SapBdcEnrollmentConfig défini, il est immuable.
sapRegion

string

Facultatif. Immuable. Région GCP à utiliser pour les API SAP BDC. Lorsque les métadonnées du catalogue sont stockées dans une région multirégionale (par exemple, "us"), mais que l'instance SAP BDC physique réside dans une seule région (par exemple, "us-central1"), ce champ doit être défini explicitement pour pointer vers cette région unique. Si aucune valeur n'est définie, l'emplacement fourni lors de la création du catalogue sera utilisé par défaut.

SapBdcEnrollmentConfig

Contient la configuration d'enregistrement reçue de SAP.

Représentation JSON 
{
  "connectorEndpoint": string,
  "invitationCode": string,
  "invitationUrl": string,
  "federatedIdentityIssuer": string
}
Champs
connectorEndpoint

string

Facultatif. Point de terminaison unique du connecteur SAP BDC.
invitationCode

string

Facultatif. Un code d'invitation de SAP.
invitationUrl

string

Facultatif. URL d'invitation combinée contenant le point de terminaison et le code.
federatedIdentityIssuer

string

Uniquement en sortie. Lakehouse permet de partager des produits de données avec SAP BDC. Lorsque le partage est activé, SAP BDC accède aux ressources sous-jacentes via une identité fédérée. Ce champ indique l'émetteur de l'identité fédérée.

Plus concrètement, le pool d'identités et le fournisseur doivent être créés comme suit :

$ gcloud iam workload-identity-pools create sap-bdc-pool \ --location="global" \ --display-name="SAP BDC Pool"

$ gcloud iam workload-identity-pools providers create-oidc sap-bdc-provider \ --location="global" \ --workload-identity-pool="sap-bdc-pool" \ --issuer-uri=""

Le pool doit ensuite pouvoir être ajouté à la stratégie IAM des ressources partagées afin que SAP BDC puisse y accéder :

$ gcloud projects add-iam-policy-binding PROJECT_ID \ --role="roles/biglake.viewer" \ --member="principal://iam.googleapis.com/projects/{PROJECT_NUMBER}/locations/global/workloadIdentityPools/sap-bdc-pool/subject/{TENANT_UUID}"

… où TENANT_UUID se trouve dans l'instance SAP BDC.

RefreshOptions

Configure les options d'actualisation d'un catalogue Delta Sharing.

Représentation JSON 
{
  "refreshSchedule": {
    object (RefreshSchedule)
  }
}
Champs
refreshSchedule

object (RefreshSchedule)

Facultatif. Définit si et quand l'actualisation des métadonnées doit être planifiée.

RefreshSchedule

Définit si et quand l'actualisation des métadonnées doit être planifiée.

Représentation JSON 
{
  "refreshInterval": string
}
Champs
refreshInterval

string (Duration format)

Facultatif. Intervalle d'actualisation des métadonnées à partir du catalogue distant. Si aucune valeur n'est définie, mais que vous souhaitez actualiser les données, une valeur par défaut du système sera utilisée.

Durée en secondes avec neuf chiffres au maximum après la virgule et se terminant par "s". Exemple : "3.5s"

RefreshStatus

État de l'actualisation en arrière-plan du catalogue distant.

Représentation JSON 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
Champs
startTime

string (Timestamp format)

Uniquement en sortie. Date et heure de début de l'actualisation du catalogue, y compris les actualisations en cours.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Uniquement en sortie. Une fois l'actualisation du catalogue terminée, définissez la valeur sur "unset" pour les actualisations en cours.

Utilise la norme RFC 3339, où la sortie générée utilise toujours le format UTC (indiqué par "Z" pour le temps universel coordonné) avec des secondes fractionnaires de 0, 3, 6 ou 9 chiffres décimaux. Des décalages horaires autres que "Z" (UTC) sont également acceptés. Exemples : "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" ou "2014-10-02T15:01:23+05:30".
status

object (Status)

Uniquement en sortie. État de la dernière opération d'actualisation en arrière-plan. Non défini pour les actualisations en cours.

FederatedCatalogOptions

Options de configuration du catalogue fédéré.

Représentation JSON 
{
  "serviceDirectoryName": string,
  "crossCloudCacheOptions": {
    object (CrossCloudCacheOptions)
  }
}
Champs
serviceDirectoryName

string

Facultatif. Nom de ressource de l'annuaire des services pour acheminer le trafic sur une connexion réseau privée via interconnexion cross-cloud, au format projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}.
crossCloudCacheOptions

object (CrossCloudCacheOptions)

Facultatif. Options de configuration pour la mise en cache multicloud des fichiers de données et de métadonnées.

CrossCloudCacheOptions

Options de configuration pour la mise en cache multicloud des fichiers de données et de métadonnées.

Représentation JSON 
{
  "enabled": boolean
}
Champs
enabled

boolean

Facultatif. Indique si la mise en cache cross-cloud des fichiers de données et de métadonnées est activée. Cela ne concerne que les requêtes via BigQuery.

Si cette valeur est définie sur true, les données et les métadonnées lues sont stockées dans un cache, ce qui peut améliorer les performances et réduire les coûts de sortie réseau pour les requêtes multicloud.

Si cette valeur est false, la mise en cache cross-cloud est désactivée.

EncryptionConfig

Configuration de chiffrement personnalisée (par exemple, clés Cloud KMS).

Représentation JSON 
{
  "kmsKeyName": string
}
Champs
kmsKeyName

string

Facultatif. Nom de la clé Cloud KMS utilisée pour chiffrer les données mises en cache extraites du catalogue. Format : projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}

Méthodes

create

 Crée un catalogue Delta Sharing.

delete

 Supprime un catalogue Delta Sharing existant spécifié par le nom de ressource.

get

 Récupère le catalogue spécifié par le nom de ressource.

list

 Répertorie tous les catalogues DeltaSharing d'un projet spécifié.

patch

 Met à jour un catalogue Delta Sharing existant.