REST Resource: deltasharing.v1.projects.catalogs

Risorsa: DeltaSharingCatalog

Rappresenta un catalogo Delta Sharing.

Rappresentazione 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)
  }
}
Campi
name

string

Identificatore. Nome della risorsa. Formato: projects/{project}/catalogs/{catalog}
location

string

Obbligatorio. Immutabile. La posizione Google Cloud fornita dall'utente del catalogo. Questo campo è immutabile.
createTime

string (Timestamp format)

Solo output. L'ora di creazione del catalogo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
updateTime

string (Timestamp format)

Solo output. L'ora dell'ultima modifica del catalogo.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
serviceAccount

string

Solo output. Il account di servizio utilizzato per la registrazione SAP e creato come effetto collaterale della creazione della risorsa catalogo Delta Sharing.
refreshOptions

object (RefreshOptions)

Facoltativo. Configura le opzioni per l'aggiornamento di un catalogo Delta Sharing.
refreshStatus

object (RefreshStatus)

Solo output. Lo stato dell'aggiornamento del catalogo in background.
federatedCatalogOptions

object (FederatedCatalogOptions)

Facoltativo. Opzioni di configurazione per i cataloghi federati.
Configurazione per il catalogo. Deve essere impostato un solo campo, che determina il tipo di catalogo. Di seguito è riportato un elenco di campi che si escludono a vicenda. In una risposta verrà impostato al massimo uno dei campi:
sapConfig

object (SapConfig)

Facoltativo. Configurazione di un catalogo che si connette a SAP Business Data Cloud (BDC).
Fine dei campi che si escludono a vicenda.
encryptionConfig

object (EncryptionConfig)

Facoltativo. Configurazione della crittografia personalizzata (ad es. chiavi Cloud KMS).

SapConfig

Configurazione per SAP Business Data Cloud (BDC).

Rappresentazione JSON 
{
  "sapBdcEnrollmentConfig": {
    object (SapBdcEnrollmentConfig)
  },
  "sapRegion": string
}
Campi
sapBdcEnrollmentConfig

object (SapBdcEnrollmentConfig)

Facoltativo. Per creare una risorsa catalogo che si connette a SAP BDC, segui questa procedura in tre passaggi: 1. Imposta SapConfig su vuoto. In questo modo viene creata una risorsa catalogo con un service account Google Cloud: serviceAccount. 2. Nella tua istanza SAP BDC, utilizzando questo serviceAccount, segui la procedura di registrazione e crea un connettore BDC. Riceverai connectorEndpoint e invitationCode da SAP. 3. Con questi campi aggiuntivi forniti da SAP, aggiorna la risorsa del catalogo BigLake creata in precedenza con SapBdcEnrollmentConfig. Una volta impostato, il SapBdcEnrollmentConfig è immutabile.
sapRegion

string

Facoltativo. Immutabile. La regione Google Cloud da utilizzare per le API SAP BDC. Quando i metadati del catalogo sono archiviati in più regioni (ad es. "us"), ma l'istanza SAP BDC fisica si trova in una singola regione (ad es. "us-central1"), questo campo deve essere impostato in modo esplicito in modo che punti a quella singola regione. Se non impostata, verrà utilizzata per impostazione predefinita la località fornita durante la creazione del catalogo.

SapBdcEnrollmentConfig

Contiene la configurazione di registrazione ricevuta da SAP.

Rappresentazione JSON 
{
  "connectorEndpoint": string,
  "invitationCode": string,
  "invitationUrl": string,
  "federatedIdentityIssuer": string
}
Campi
connectorEndpoint

string

Facoltativo. L'endpoint connettore SAP BDC univoco.
invitationCode

string

Facoltativo. Un codice di invito di SAP.
invitationUrl

string

Facoltativo. L'URL di invito combinato contenente sia l'endpoint che il codice.
federatedIdentityIssuer

string

Solo output. Lakehouse supporta la condivisione dei prodotti dati con SAP BDC. Quando la condivisione è abilitata, SAP BDC accederà alle risorse sottostanti tramite un'identità federata. Questo campo indica l'emittente dell'identità federata.

Più concretamente, il pool di identità e il provider devono essere creati come segue:

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

Il pool può quindi essere aggiunto al criterio IAM delle risorse condivise in modo che SAP BDC possa accedervi:

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

… dove TENANT_UUID si trova nell'istanza SAP BDC.

RefreshOptions

Configura le opzioni per l'aggiornamento di un catalogo Delta Sharing.

Rappresentazione JSON 
{
  "refreshSchedule": {
    object (RefreshSchedule)
  }
}
Campi
refreshSchedule

object (RefreshSchedule)

Facoltativo. Definisce se e quando deve essere pianificato l'aggiornamento dei metadati.

RefreshSchedule

Definisce se e quando deve essere pianificato l'aggiornamento dei metadati.

Rappresentazione JSON 
{
  "refreshInterval": string
}
Campi
refreshInterval

string (Duration format)

Facoltativo. L'intervallo per l'aggiornamento dei metadati dal catalogo remoto. Se non è impostato, ma è necessario l'aggiornamento, verrà utilizzato un valore predefinito di sistema.

Una durata in secondi con un massimo di nove cifre frazionarie, che termina con "s". Esempio: "3.5s".

RefreshStatus

Stato dell'aggiornamento in background del catalogo remoto.

Rappresentazione JSON 
{
  "startTime": string,
  "endTime": string,
  "status": {
    object (Status)
  }
}
Campi
startTime

string (Timestamp format)

Solo output. Quando è iniziato l'aggiornamento del catalogo, inclusi gli aggiornamenti in corso.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
endTime

string (Timestamp format)

Solo output. Al termine dell'aggiornamento del catalogo, annulla l'impostazione per gli aggiornamenti in corso.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
status

object (Status)

Solo output. Lo stato dell'ultima operazione di aggiornamento in background, non impostato per gli aggiornamenti in corso.

FederatedCatalogOptions

Opzioni di configurazione per il catalogo federato.

Rappresentazione JSON 
{
  "serviceDirectoryName": string,
  "crossCloudCacheOptions": {
    object (CrossCloudCacheOptions)
  }
}
Campi
serviceDirectoryName

string

Facoltativo. Il nome della risorsa della directory di servizio per instradare il traffico su una connessione di rete privata tramite Cross-Cloud Interconnect, nel formato projects/{projectId}/locations/{locationId}/namespaces/{namespace_id}/services/{serviceId}.
crossCloudCacheOptions

object (CrossCloudCacheOptions)

Facoltativo. Opzioni di configurazione per la memorizzazione nella cache cross-cloud dei file di dati e metadati.

CrossCloudCacheOptions

Opzioni di configurazione per la memorizzazione nella cache cross-cloud dei file di dati e metadati.

Rappresentazione JSON 
{
  "enabled": boolean
}
Campi
enabled

boolean

Facoltativo. Specifica se la memorizzazione nella cache cross-cloud dei file di dati e metadati è abilitata. Questo influisce solo sulle query tramite BigQuery.

Se questo valore è true, i dati e i metadati di lettura vengono archiviati in una cache, il che può aumentare le prestazioni e ridurre i costi di uscita dalla rete per le query cross-cloud.

Se questo valore è false, la memorizzazione nella cache cross-cloud è disabilitata.

EncryptionConfig

Configurazione della crittografia personalizzata (ad es. chiavi Cloud KMS).

Rappresentazione JSON 
{
  "kmsKeyName": string
}
Campi
kmsKeyName

string

Facoltativo. Nome della chiave Cloud KMS utilizzata per criptare i dati memorizzati nella cache recuperati dal catalogo. Formato: projects/{project}/locations/{location}/keyRings/{keyRing}/cryptoKeys/{cryptoKey}

Metodi

create

 Crea un nuovo catalogo Delta Sharing.

delete

 Elimina un catalogo Delta Sharing esistente specificato dal nome della risorsa.

get

 Recupera il catalogo specificato dal nome della risorsa.

list

 Elenca tutti i cataloghi Delta Sharing in un progetto specificato.

patch

 Aggiorna un catalogo Delta Sharing esistente.