REST Resource: deltasharing.v1.projects.catalogs

Recurso: DeltaSharingCatalog

Representa un catálogo de Delta Sharing.

Representación 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)
  }
}
Campos
name

string

Es el identificador. Nombre del recurso. Formato: projects/{project}/catalogs/{catalog}
location

string

Obligatorio. Inmutable. Es la ubicación de GCP del catálogo proporcionada por el usuario. Este campo es inmutable.
createTime

string (Timestamp format)

Solo salida. La hora de creación del catálogo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo salida. La hora de la última modificación del catálogo.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serviceAccount

string

Solo salida. Es la cuenta de servicio que se usa para la inscripción de SAP y se crea como efecto secundario de la creación del recurso de catálogo de Delta Sharing.
refreshOptions

object (RefreshOptions)

Es opcional. Configura las opciones para actualizar un catálogo de Delta Sharing.
refreshStatus

object (RefreshStatus)

Solo salida. Es el estado de la actualización del catálogo en segundo plano.
federatedCatalogOptions

object (FederatedCatalogOptions)

Es opcional. Son las opciones de configuración para los catálogos federados.
Es la configuración del catálogo. Se debe establecer exactamente un campo, que determina el tipo de catálogo. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
sapConfig

object (SapConfig)

Es opcional. Es la configuración de un catálogo que se conecta a SAP Business Data Cloud (BDC).
Fin de los campos mutuamente excluyentes.
encryptionConfig

object (EncryptionConfig)

Es opcional. Configuración de encriptación personalizada (p. ej., claves de Cloud KMS)

SapConfig

Es la configuración de SAP Business Data Cloud (BDC).

Representación JSON 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
Campos
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

Es opcional. Para crear un recurso de catálogo que se conecte a SAP BDC, sigue este proceso de 3 pasos: 1. Establece SapConfig como vacío. Esto crea un recurso de catálogo con una cuenta de servicio de GCP: serviceAccount. 2. En tu instancia de SAP BDC, usa este serviceAccount, sigue el proceso de inscripción y crea un conector de BDC. Recibirás connectorEndpoint y invitationCode de SAP. 3. Con estos campos adicionales proporcionados por SAP, actualiza el recurso del catálogo de BigLake creado anteriormente con SapBdcEnrollmentConfig. Una vez que se establece el SapBdcEnrollmentConfig, es inmutable.
sapRegion

string

Es opcional. Inmutable. Es la región de GCP que se usará para las APIs de SAP BDC. Cuando los metadatos del catálogo se almacenan en una multirregión (p.ej., "us"), pero la instancia física de SAP BDC reside en una sola región (p.ej., "us-central1"), este campo debe establecerse de forma explícita para que apunte a esa sola región. Si no se configura, se usará de forma predeterminada la ubicación proporcionada durante la creación del catálogo.

SapBdcEnrollmentConfig

Contiene la configuración de inscripción recibida de SAP.

Representación JSON 
{
  "connectorEndpoint": string,
  "invitationCode": string,
  "invitationUrl": string,
  "federatedIdentityIssuer": string
}
Campos
connectorEndpoint

string

Es opcional. Es el extremo único del conector de SAP BDC.
invitationCode

string

Es opcional. Un código de invitación de SAP
invitationUrl

string

Es opcional. Es la URL de invitación combinada que contiene el extremo y el código.
federatedIdentityIssuer

string

Solo salida. Lakehouse admite el uso compartido de productos de datos con SAP BDC. Cuando se habilita el uso compartido, SAP BDC accederá a los recursos subyacentes a través de una identidad federada. Este campo indica la entidad emisora de la identidad federada.

Más concretamente, el grupo y el proveedor de identidades se deben crear de la siguiente manera:

$ 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=""

Luego, se puede agregar el grupo a la política de IAM de los recursos compartidos para que SAP BDC pueda acceder a ellos:

$ 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}"

… donde TENANT_UUID se puede encontrar en la instancia de SAP BDC.

RefreshOptions

Configura las opciones para actualizar un catálogo de Delta Sharing.

Representación JSON 
{
  "refreshSchedule": {
    object (RefreshSchedule)
  }
}
Campos
refreshSchedule

object (RefreshSchedule)

Es opcional. Define si se debe programar la actualización de metadatos y cuándo.

RefreshSchedule

Define si se debe programar la actualización de metadatos y cuándo.

Representación JSON 
{
  "refreshInterval": string
}
Campos
refreshInterval

string (Duration format)

Es opcional. Es el intervalo para actualizar los metadatos del catálogo remoto. Si no se configura, pero se desea actualizar, se usará un valor predeterminado del sistema.

Una duración en segundos con hasta nueve dígitos decimales, que terminan en “s”. Ejemplo: "3.5s".

RefreshStatus

Es el estado de la actualización en segundo plano del catálogo remoto.

Representación JSON 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
Campos
startTime

string (Timestamp format)

Solo salida. Fecha y hora en que se inició la actualización del catálogo, incluidas las actualizaciones en curso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo salida. Cuando finaliza la actualización del catálogo, se anula la configuración para las actualizaciones en curso.

Usa el formato RFC 3339, en el que el resultado generado siempre usará la normalización Z y los dígitos fraccionarios 0, 3, 6 o 9. También se aceptan otras compensaciones que no sean “Z”. Ejemplos: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
status

object (Status)

Solo salida. Es el estado de la última operación de actualización en segundo plano. No se establece para las actualizaciones en curso.

FederatedCatalogOptions

Son las opciones de configuración del catálogo federado.

Representación JSON 
{
  "serviceDirectoryName": string,
  "crossCloudCacheOptions": {
    object (CrossCloudCacheOptions)
  }
}
Campos
serviceDirectoryName

string

Es opcional. Nombre del recurso del directorio de servicios para enrutar el tráfico a través de una conexión de red privada por medio de Cross‑Cloud Interconnect, con el formato projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}.
crossCloudCacheOptions

object (CrossCloudCacheOptions)

Es opcional. Son opciones de configuración para el almacenamiento en caché multinube de archivos de datos y metadatos.

CrossCloudCacheOptions

Son opciones de configuración para el almacenamiento en caché multinube de archivos de datos y metadatos.

Representación JSON 
{
  "enabled": boolean
}
Campos
enabled

boolean

Es opcional. Especifica si está habilitado el almacenamiento en caché multinube de archivos de datos y metadatos. Esto solo afecta las consultas a través de BigQuery.

Si este valor es true, los datos de lectura y los metadatos se almacenan en una caché, lo que puede aumentar el rendimiento y reducir los costos de salida de red para las consultas multinube.

Si este valor es false, se inhabilita el almacenamiento en caché multinube.

EncryptionConfig

Configuración de encriptación personalizada (p. ej., claves de Cloud KMS)

Representación JSON 
{
  "kmsKeyName": string
}
Campos
kmsKeyName

string

Es opcional. Es el nombre de la clave de Cloud KMS que se usa para encriptar los datos almacenados en caché que se recuperan del catálogo. Formato: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}

Métodos

create

 Crea un catálogo de Delta Sharing nuevo.

delete

 Borra un catálogo existente de Delta Sharing especificado por el nombre del recurso.

get

 Obtiene el catálogo que especifica el nombre del recurso.

list

 Enumera todos los catálogos de DeltaSharing en un proyecto especificado.

patch

 Actualiza un catálogo de DeltaSharing existente.