REST Resource: projects.locations.services

Recurso: Serviço

Um serviço de metastore gerenciado que atende consultas de metadados.

Representação JSON
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "network": string,
  "endpointUri": string,
  "port": integer,
  "state": enum (State),
  "stateMessage": string,
  "artifactGcsUri": string,
  "tier": enum (Tier),
  "metadataIntegration": {
    object (MetadataIntegration)
  },
  "maintenanceWindow": {
    object (MaintenanceWindow)
  },
  "uid": string,
  "metadataManagementActivity": {
    object (MetadataManagementActivity)
  },
  "releaseChannel": enum (ReleaseChannel),
  "encryptionConfig": {
    object (EncryptionConfig)
  },
  "networkConfig": {
    object (NetworkConfig)
  },
  "databaseType": enum (DatabaseType),
  "telemetryConfig": {
    object (TelemetryConfig)
  },
  "scalingConfig": {
    object (ScalingConfig)
  },
  "multiRegionConfig": {
    object (MultiRegionConfig)
  },
  "scheduledBackup": {
    object (ScheduledBackup)
  },
  "deletionProtection": boolean,

  // Union field metastore_config can be only one of the following:
  "hiveMetastoreConfig": {
    object (HiveMetastoreConfig)
  }
  // End of list of possible types for union field metastore_config.
}
Campos
name

string

Imutável. O nome do recurso relativo do serviço de metastore, no seguinte formato:

projects/{projectNumber}/locations/{locationId}/services/{serviceId}

createTime

string (Timestamp format)

Apenas saída. O horário em que o serviço de metastore foi criado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Apenas saída. A hora em que o serviço da metastore foi atualizado pela última vez.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Rótulos definidos pelo usuário para o serviço de metastore.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

network

string

Imutável. O nome do recurso relativo da rede VPC em que a instância pode ser acessada. Ele é especificado da seguinte forma:

projects/{projectNumber}/global/networks/{network_id}

endpointUri

string

Apenas saída. O URI do endpoint usado para acessar o serviço do metastore.

port

integer

A porta TCP em que o serviço do metastore é alcançada. Padrão: 9083

state

enum (State)

Apenas saída. O estado atual do serviço da metastore.

stateMessage

string

Apenas saída. Outras informações sobre o estado atual do serviço de metastore, se disponíveis.

artifactGcsUri

string

Apenas saída. Um URI do Cloud Storage (começando com gs://) que especifica onde os artefatos relacionados ao serviço de metastore são armazenados.

tier

enum (Tier)

O nível do serviço.

metadataIntegration

object (MetadataIntegration)

Opcional. A configuração que define como os metadados do metastore precisam ser integrados a serviços e sistemas externos.

maintenanceWindow

object (MaintenanceWindow)

Janela de manutenção de uma hora do serviço da metastore. Isso especifica quando o serviço pode ser reiniciado para fins de manutenção no horário UTC. A janela de manutenção não é necessária para serviços com o tipo de banco de dados SPANNER.

uid

string

Apenas saída. O identificador de recurso globalmente exclusivo do serviço de metastore.

metadataManagementActivity

object (MetadataManagementActivity)

Apenas saída. As atividades de gerenciamento de metadados do serviço de metastore.

releaseChannel

enum (ReleaseChannel)

Imutável. O canal de lançamento do serviço. Se não for especificado, STABLE assumirá como padrão.

encryptionConfig

object (EncryptionConfig)

Imutável. Informações usadas para configurar o serviço do Dataproc Metastore para criptografar os dados do cliente em repouso. Não foi possível atualizar.

networkConfig

object (NetworkConfig)

A configuração que especifica as configurações de rede para o serviço do metastore do Dataproc.

databaseType

enum (DatabaseType)

Imutável. O tipo de banco de dados em que o serviço do Metastore armazena os dados.

telemetryConfig

object (TelemetryConfig)

A configuração que especifica as configurações de telemetria para o serviço Metastore do Dataproc. Se não for especificado, JSON será usado como padrão.

scalingConfig

object (ScalingConfig)

Configurações de escalonamento do serviço de metastore.

multiRegionConfig

object (MultiRegionConfig)

Opcional. Especifica as informações de configuração multirregional para o serviço de metastore do Hive.

scheduledBackup

object (ScheduledBackup)

Opcional. A configuração do backup programado para o serviço de metastore.

deletionProtection

boolean

Opcional. Indica se o metastore do Dataproc precisa ser protegido contra exclusões acidentais.

Campo de união metastore_config. Propriedades de configuração específicas da tecnologia de serviço de metastore (o software que atende consultas de metastore). metastore_config pode ser apenas de um dos tipos a seguir:
hiveMetastoreConfig

object (HiveMetastoreConfig)

Informações de configuração específicas para executar o software do metastore do Hive como o serviço de metastore.

HiveMetastoreConfig

Especifica informações de configuração específicas para executar o software do metastore do Hive como o serviço do metastore.

Representação JSON
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "kerberosConfig": {
    object (KerberosConfig)
  },
  "endpointProtocol": enum (EndpointProtocol),
  "auxiliaryVersions": {
    string: {
      object (AuxiliaryVersionConfig)
    },
    ...
  }
}
Campos
version

string

Imutável. A versão do esquema do metastore do Hive.

configOverrides

map (key: string, value: string)

Um mapeamento de pares de chave-valor de configuração do metastore do Hive a serem aplicados a ele (configurado em hive-site.xml). Os mapeamentos substituem os padrões do sistema (algumas chaves não podem ser substituídas). Essas substituições também são aplicadas a versões auxiliares e podem ser personalizadas no AuxiliaryVersionConfig da versão auxiliar.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

kerberosConfig

object (KerberosConfig)

Informações usadas para configurar o serviço do metastore do Hive como um principal do serviço em um realm do Kerberos. Para desativar o Kerberos, use o método services.patch e especifique o caminho desse campo (hiveMetastoreConfig.kerberos_config) no updateMask da solicitação, omitindo esse campo do service da solicitação.

endpointProtocol

enum (EndpointProtocol)

O protocolo a ser usado para o endpoint de serviço do metastore. Se não for especificado, THRIFT assumirá como padrão.

auxiliaryVersions

map (key: string, value: object (AuxiliaryVersionConfig))

Um mapeamento da versão do metastore do Hive para a configuração da versão auxiliar. Quando especificado, um serviço secundário de metastore do Hive é criado com o serviço principal. Todas as versões auxiliares precisam ser anteriores à versão principal do serviço. A chave é o nome do serviço auxiliar e precisa corresponder à expressão regular a-z?. Isso significa que o primeiro caractere precisa ser uma letra minúscula, e todos os seguintes precisam ser hífen, letra minúscula ou dígito, exceto o último, que não pode ser um hífen.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

KerberosConfig

Informações de configuração para um principal do Kerberos.

Representação JSON
{
  "keytab": {
    object (Secret)
  },
  "principal": string,
  "krb5ConfigGcsUri": string
}
Campos
keytab

object (Secret)

Um arquivo keytab do Kerberos que pode ser usado para autenticar um principal de serviço com um centro de distribuição de chaves (KDC, na sigla em inglês) do Kerberos.

principal

string

Um principal do Kerberos que existe no keytab e no KDC para autenticação. Um principal típico é do formato primary/instance@REALM, mas não há um formato exato.

krb5ConfigGcsUri

string

Um URI do Cloud Storage que especifica o caminho para um arquivo krb5.conf. Ele tem o formato gs://{bucket_name}/path/to/krb5.conf, embora o arquivo não precise ser nomeado krb5.conf explicitamente.

Secret

Um valor armazenado com segurança.

Representação JSON
{

  // Union field value can be only one of the following:
  "cloudSecret": string
  // End of list of possible types for union field value.
}
Campos

Campo de união value.

value pode ser apenas de um dos tipos a seguir:

cloudSecret

string

O nome do recurso relativo de uma versão do secret do Secret Manager, neste formato:

projects/{projectNumber}/secrets/{secret_id}/versions/{version_id}

EndpointProtocol

Protocolos disponíveis para veicular o endpoint de serviço do metastore.

Enums
ENDPOINT_PROTOCOL_UNSPECIFIED O protocolo não foi definido.
THRIFT Use o protocolo Apache Thrift legado para o endpoint de serviço do metastore.
GRPC Use o protocolo gRPC modernizado para o endpoint de serviço do metastore.

AuxiliaryVersionConfig

Informações de configuração das versões auxiliares do serviço.

Representação JSON
{
  "version": string,
  "configOverrides": {
    string: string,
    ...
  },
  "networkConfig": {
    object (NetworkConfig)
  }
}
Campos
version

string

A versão do metastore do Hive do serviço auxiliar. Ela precisa ser menor que a versão principal do serviço do metastore do Hive.

configOverrides

map (key: string, value: string)

Um mapeamento de pares de chave-valor de configuração do metastore do Hive a serem aplicados ao metastore auxiliar do Hive (configurado em hive-site.xml), além das substituições da versão principal. Se as chaves estiverem presentes nas substituições da versão auxiliar e da versão principal, o valor das substituições da versão auxiliar terá precedência.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

networkConfig

object (NetworkConfig)

Apenas saída. A configuração de rede contém os URIs de endpoint do serviço auxiliar do metastore do Hive.

NetworkConfig

Configuração de rede para o serviço do metastore do Dataproc.

Representação JSON
{
  "consumers": [
    {
      object (Consumer)
    }
  ],
  "customRoutesEnabled": boolean
}
Campos
consumers[]

object (Consumer)

Imutável. A configuração de rede do lado do consumidor para a instância do metastore do Dataproc.

customRoutesEnabled

boolean

Permite que as rotas personalizadas sejam importadas e exportadas para a rede VPC com peering do serviço do Dataproc Metastore.

Consumidor

Contém informações sobre as configurações de rede do cliente.

Representação JSON
{
  "endpointUri": string,
  "endpointLocation": string,

  // Union field vpc_resource can be only one of the following:
  "subnetwork": string
  // End of list of possible types for union field vpc_resource.
}
Campos
endpointUri

string

Apenas saída. O URI do endpoint usado para acessar o serviço do metastore.

endpointLocation

string

Apenas saída. O local do URI do endpoint. Formato: projects/{project}/locations/{location}.

Campo de união vpc_resource.

vpc_resource pode ser apenas de um dos tipos a seguir:

subnetwork

string

Imutável. A sub-rede do projeto do cliente em que um endereço IP é reservado e usado como o endpoint do serviço do metastore do Dataproc. Ele é acessível para hosts na sub-rede e para todos os hosts em uma sub-rede na mesma região e na mesma rede. É preciso que pelo menos um endereço IP esteja disponível no intervalo principal da sub-rede. A sub-rede é especificada no seguinte formulário:

projects/{projectNumber}/regions/{region_id}/subnetworks/{subnetwork_id}

Estado

O estado atual do serviço da metastore.

Enums
STATE_UNSPECIFIED O estado do serviço de metastore é desconhecido.
CREATING O serviço de metastore está em processo de criação.
ACTIVE O serviço da metastore está em execução e pronto para atender consultas.
SUSPENDING O serviço de metastore está entrando em suspensão. A disponibilidade de fornecimento de consultas pode ser interrompida inesperadamente.
SUSPENDED O serviço da metastore está suspenso e não pode atender consultas.
UPDATING O serviço da metastore está sendo atualizado. Ele continua utilizável, mas não é possível aceitar outras solicitações de atualização nem excluí-lo no momento.
DELETING O serviço de metastore está sendo excluído. Não é possível usar.
ERROR O serviço de metastore encontrou um erro e não pode ser usado. O serviço da metastore precisa ser excluído.
AUTOSCALING O serviço Metastore do Dataproc 2 está sendo dimensionado para cima ou para baixo.
MIGRATING O serviço de metastore está processando uma migração gerenciada.

Nível

Níveis de serviço disponíveis.

Enums
TIER_UNSPECIFIED A categoria não foi definida.
DEVELOPER O nível do desenvolvedor oferece escalonabilidade limitada e nenhuma tolerância a falhas. Isso é bom para provas de conceito de baixo custo.
ENTERPRISE O nível empresarial oferece alta disponibilidade em várias zonas e escalabilidade suficiente para cargas de trabalho do Dataproc Metastore de nível empresarial.

MetadataIntegration

Especifica como os metadados do metastore precisam ser integrados a serviços externos.

Representação JSON
{
  "dataCatalogConfig": {
    object (DataCatalogConfig)
  },
  "dataplexConfig": {
    object (DataplexConfig)
  }
}
Campos
dataCatalogConfig

object (DataCatalogConfig)

Opcional. A configuração de integração do serviço do Data Catalog.

dataplexConfig

object (DataplexConfig)

A configuração de integração do serviço do Dataplex.

DataCatalogConfig

Especifica como os metadados do metastore precisam ser integrados ao serviço do Data Catalog.

Representação JSON
{
  "enabled": boolean
}
Campos
enabled

boolean

Opcional. Define se os metadados do metastore precisam ser sincronizados com o Data Catalog. O valor padrão é desativar a sincronização dos metadados do metastore com o Data Catalog.

DataplexConfig

Especifica como os metadados do metastore precisam ser integrados ao serviço do Dataplex.

Representação JSON
{
  "lakeResources": {
    string: {
      object (Lake)
    },
    ...
  }
}
Campos
lakeResources

map (key: string, value: object (Lake))

Uma referência aos recursos do lake a que este serviço de metastore está anexado. A chave é o nome do recurso do lago. Exemplo: projects/{projectNumber}/locations/{locationId}/lakes/{lake_id}.

Um objeto com uma lista de pares "key": value. Exemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Lake

Representa um recurso Lake

Representação JSON
{
  "name": string
}
Campos
name

string

O nome do recurso do lago. Exemplo: projects/{projectNumber}/locations/{locationId}/lakes/{lake_id}

MaintenanceWindow

Janela de manutenção Isso especifica quando o Dataproc Metastore pode realizar a operação de manutenção do sistema no serviço.

Representação JSON
{
  "hourOfDay": integer,
  "dayOfWeek": enum (DayOfWeek)
}
Campos
hourOfDay

integer

A hora do dia (0 a 23) em que a janela começa.

dayOfWeek

enum (DayOfWeek)

O dia da semana em que a janela começa.

MetadataManagementActivity

As atividades de gerenciamento de metadados do serviço de metastore.

Representação JSON
{
  "metadataExports": [
    {
      object (MetadataExport)
    }
  ],
  "restores": [
    {
      object (Restore)
    }
  ]
}
Campos
metadataExports[]

object (MetadataExport)

Apenas saída. As exportações de metadados mais recentes do serviço do metastore.

restores[]

object (Restore)

Apenas saída. As restaurações mais recentes do serviço da metastore.

MetadataExport

Detalhes de uma operação de exportação de metadados.

Representação JSON
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "databaseDumpType": enum (Type),

  // Union field destination can be only one of the following:
  "destinationGcsUri": string
  // End of list of possible types for union field destination.
}
Campos
startTime

string (Timestamp format)

Apenas saída. O horário em que a exportação começou.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Apenas saída. O horário em que a exportação foi concluída.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Apenas saída. O estado atual da exportação.

databaseDumpType

enum (Type)

Apenas saída. O tipo de despejo do banco de dados.

Campo de união destination.

destination pode ser apenas de um dos tipos a seguir:

destinationGcsUri

string

Apenas saída. Um URI do Cloud Storage de uma pasta para onde os metadados são exportados, no formato gs://<bucket_name>/<path_inside_bucket>/<export_folder>, em que <export_folder> é gerado automaticamente.

Estado

O estado atual da exportação de metadados.

Enums
STATE_UNSPECIFIED O estado da exportação de metadados é desconhecido.
RUNNING A exportação de metadados está em execução.
SUCCEEDED A exportação de metadados foi concluída.
FAILED A exportação de metadados falhou.
CANCELLED A exportação de metadados é cancelada.

Restaurar

Detalhes de uma operação de restauração de metadados.

Representação JSON
{
  "startTime": string,
  "endTime": string,
  "state": enum (State),
  "backup": string,
  "type": enum (RestoreType),
  "details": string,
  "backupLocation": string
}
Campos
startTime

string (Timestamp format)

Apenas saída. Hora em que a restauração começou.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

endTime

string (Timestamp format)

Apenas saída. O horário em que a restauração foi concluída.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Apenas saída. O estado atual da restauração.

backup

string

Apenas saída. O nome do recurso relativo do backup do serviço do metastore a ser restaurado, neste formato:

projects/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}

type

enum (RestoreType)

Apenas saída. O tipo de restauração.

details

string

Apenas saída. Os detalhes de restauração que contêm a revisão do serviço a ser restaurado, no formato JSON.

backupLocation

string

Opcional. Um URI do Cloud Storage que especifica onde os artefatos de backup são armazenados, no formato gs://<bucket_name>/<path_inside_bucket>.

Estado

O estado atual da restauração.

Enums
STATE_UNSPECIFIED O estado da restauração de metadados é desconhecido.
RUNNING A restauração de metadados está em execução.
SUCCEEDED A restauração de metadados foi concluída.
FAILED Falha na restauração de metadados.
CANCELLED A restauração de metadados é cancelada.

RestoreType

O tipo de restauração. Se não for especificado, METADATA_ONLY assumirá como padrão.

Enums
RESTORE_TYPE_UNSPECIFIED O tipo de restauração é desconhecido.
FULL Os metadados e a configuração do serviço são restaurados.
METADATA_ONLY Somente os metadados do serviço são restaurados.

ReleaseChannel

Os canais de lançamento agrupam recursos de diferentes níveis de estabilidade. Os recursos mais recentes podem ser introduzidos inicialmente em canais de lançamento menos estáveis e promovidos automaticamente para canais de lançamento mais estáveis.

Enums
RELEASE_CHANNEL_UNSPECIFIED O canal de lançamento não foi especificado.
CANARY O canal de lançamento CANARY contém os recursos mais recentes, que podem ser instáveis e estar sujeitos a problemas não resolvidos sem soluções alternativas conhecidas. Os serviços que usam o canal de lançamento CANARY não estão sujeitos a nenhum SLA.
STABLE O canal de lançamento STABLE contém recursos considerados estáveis e que foram validados para uso em produção.

EncryptionConfig

Configurações de criptografia do serviço.

Representação JSON
{
  "kmsKey": string
}
Campos
kmsKey

string

O cliente forneceu o nome da chave do Cloud KMS totalmente qualificado para usar na criptografia dos dados do cliente, no seguinte formato:

projects/{projectNumber}/locations/{locationId}/keyRings/{key_ring_id}/cryptoKeys/{crypto_key_id}

DatabaseType

O tipo de banco de dados de back-end do serviço de metastore.

Enums
DATABASE_TYPE_UNSPECIFIED O DATABASE_TYPE não está definido.
MYSQL O MySQL é usado para manter os dados da metastore.
SPANNER O Spanner é usado para manter os dados da metastore.

TelemetryConfig

Configuração de telemetria para o serviço do metastore do Dataproc.

Representação JSON
{
  "logFormat": enum (LogFormat)
}
Campos
logFormat

enum (LogFormat)

O formato de saída dos registros do serviço Metastore do Dataproc.

LogFormat

Enums
LOG_FORMAT_UNSPECIFIED O LOG_FORMAT não está definido.
LEGACY A saída de registro usa o formato textPayload legado.
JSON A saída de registro usa o formato jsonPayload.

ScalingConfig

Representa a configuração de escalonamento de um serviço de metastore.

Representação JSON
{
  "autoscalingConfig": {
    object (AutoscalingConfig)
  },

  // Union field scaling_model can be only one of the following:
  "instanceSize": enum (InstanceSize),
  "scalingFactor": number
  // End of list of possible types for union field scaling_model.
}
Campos
autoscalingConfig

object (AutoscalingConfig)

Opcional. A configuração do escalonamento automático.

Campo de união scaling_model. Representa um tamanho de instância predeterminado ou um fator de escalonamento numérico. scaling_model pode ser apenas de um dos tipos a seguir:
instanceSize

enum (InstanceSize)

Um tipo enumerado de tamanhos de instância legíveis, com cada tamanho de instância mapeado para um valor flutuante (por exemplo, InstanceSize.EXTRA_SMALL = scalingFactor(0.1))

scalingFactor

number

Fator de escalonamento, incrementos de 0,1 para valores menores que 1,0 e incrementos de 1,0 para valores maiores que 1,0.

InstanceSize

Tamanhos de instâncias do Metastore.

Enums
INSTANCE_SIZE_UNSPECIFIED Tamanho da instância não especificado
EXTRA_SMALL Tamanho de instância extrapequeno, mapeado para um fator de escalonamento de 0,1.
SMALL Tamanho de instância pequeno, mapeado para um fator de escalonamento de 0,5.
MEDIUM Tamanho de instância médio, mapeado para um fator de escalonamento de 1,0.
LARGE Tamanho de instância grande, mapeado para um fator de escalonamento de 3,0.
EXTRA_LARGE Tamanho de instância extra grande, mapeado para um fator de escalonamento de 6,0.

AutoscalingConfig

Representa a configuração de escalonamento automático de um serviço de metastore.

Representação JSON
{
  "autoscalingFactor": number,
  "autoscalingEnabled": boolean,
  "limitConfig": {
    object (LimitConfig)
  }
}
Campos
autoscalingFactor

number

Apenas saída. O fator de escalonamento de um serviço com o escalonamento automático ativado.

autoscalingEnabled

boolean

Opcional. Indica se o escalonamento automático está ativado para este serviço.

limitConfig

object (LimitConfig)

Opcional. O LimitConfig do serviço.

LimitConfig

Representa a configuração do limite de escalonamento automático de um serviço de metastore.

Representação JSON
{
  "maxScalingFactor": number,
  "minScalingFactor": number
}
Campos
maxScalingFactor

number

Opcional. O maior fator de escalonamento para o qual o serviço precisa ser escalonado automaticamente.

minScalingFactor

number

Opcional. O menor fator de escalonamento para o qual o serviço precisa ser escalonado automaticamente.

MultiRegionConfig

A configuração de várias regiões para o serviço do metastore do Dataproc.

Representação JSON
{
  "certificates": [
    {
      object (RootCACertificate)
    }
  ],
  "customRegionConfig": {
    object (CustomRegionConfig)
  }
}
Campos
certificates[]
(deprecated)

object (RootCACertificate)

Apenas saída. A lista de certificados de AC raiz que um cliente gRPC usa para se conectar a um serviço de metastore do Dataproc multirregional.

customRegionConfig

object (CustomRegionConfig)

RootCACertificate

Um cliente gRPC precisa instalar todos os certificados de AC raiz para se conectar a um serviço do Dataproc Metastore multirregional e conseguir o failover.

Representação JSON
{
  "certificate": string,
  "expirationTime": string
}
Campos
certificate
(deprecated)

string

O certificado da CA raiz no formato PEM. O comprimento máximo é de 65.536 bytes.

expirationTime
(deprecated)

string (Timestamp format)

O tempo de expiração do certificado no formato de carimbo de data/hora.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

CustomRegionConfig

Configuração personalizada usada para especificar as regiões em que o serviço de metastore é executado. No momento, esse recurso está disponível apenas na região múltipla us.

Representação JSON
{
  "readWriteRegions": [
    string
  ],
  "readOnlyRegions": [
    string
  ]
}
Campos
readWriteRegions[]

string

Obrigatório. A lista de regiões de leitura e gravação em que o serviço de metastore é executado. Essas regiões precisam fazer parte (ou ser um subconjunto) da multirregião.

readOnlyRegions[]

string

Opcional. A lista de regiões somente leitura em que o serviço de metastore é executado. Essas regiões precisam fazer parte (ou ser um subconjunto) da multirregião.

ScheduledBackup

Especifica a configuração do backup programado.

Representação JSON
{
  "enabled": boolean,
  "cronSchedule": string,
  "timeZone": string,
  "nextScheduledTime": string,
  "backupLocation": string,
  "latestBackup": {
    object (LatestBackup)
  }
}
Campos
enabled

boolean

Opcional. Define se o backup programado está ativado. O valor padrão é falso.

cronSchedule

string

Opcional. O intervalo programado no formato Cron. Consulte https://pt.wikipedia.org/wiki/Cron O padrão é vazio: o backup programado não está ativado. Precisa ser especificado para ativar os backups programados.

timeZone

string

Opcional. Especifica o fuso horário a ser usado ao interpretar cronSchedule. Precisa ser um nome de fuso horário do banco de dados de fusos horários (https://en.wikipedia.org/wiki/List_of_tz_database_time_zones), por exemplo, "America/Los_Angeles" ou "Africa/Abidjan". Se não for especificado, o padrão será UTC.

nextScheduledTime

string (Timestamp format)

Apenas saída. A hora em que a próxima execução de backups está programada para começar.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

backupLocation

string

Opcional. Um URI do Cloud Storage de uma pasta, no formato gs://<bucket_name>/<path_inside_bucket>. Uma subpasta <backup_folder> com arquivos de backup será armazenada abaixo dela.

latestBackup

object (LatestBackup)

Apenas saída. Os detalhes do último backup programado.

LatestBackup

Os detalhes do último backup programado.

Representação JSON
{
  "backupId": string,
  "startTime": string,
  "state": enum (State),
  "duration": string
}
Campos
backupId

string

Apenas saída. O ID de um backup programado em andamento. Vazia se nenhum backup estiver em andamento.

startTime

string (Timestamp format)

Apenas saída. Hora em que o backup foi iniciado.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Apenas saída. O estado atual do backup.

duration

string (Duration format)

Apenas saída. A duração da conclusão do backup.

Duração em segundos com até nove dígitos fracionários, terminando em "s". Exemplo: "3.5s".

Estado

O estado atual do backup.

Enums
STATE_UNSPECIFIED O estado do backup é desconhecido.
IN_PROGRESS O backup está em andamento.
SUCCEEDED O backup foi concluído.
FAILED O backup falhou.

Métodos

alterLocation

Alterar o local do recurso de metadados.

alterTableProperties

Alterar as propriedades da tabela de metadados.

cancelMigration

Cancela o processo de migração gerenciada em andamento.

completeMigration

Conclui o processo de migração gerenciada.

create

Cria um serviço de metastore em um projeto e local.

delete

Exclui um único serviço.

exportMetadata

Exporta metadados de um serviço.

get

Recebe os detalhes de um único serviço.

getIamPolicy

Busca a política de controle de acesso de um recurso.

list

Lista serviços em um projeto e local.

moveTableToDatabase

Mover uma tabela para outro banco de dados.

patch

Atualiza os parâmetros de um único serviço.

queryMetadata

Consultar metadados do Dataproc Metastore.

removeIamPolicy

Remove as políticas do IAM anexadas a um recurso

restore

Restaura um serviço de um backup.

setIamPolicy

Define a política de controle de acesso no recurso especificado.

startMigration

Inicia o processo de migração gerenciada.

testIamPermissions

Retorna permissões do autor da chamada no recurso especificado.