- Recurso: serviço
- Representação JSON
- HiveMetastoreConfig
- KerberosConfig
- Secret
- EndpointProtocol
- AuxiliaryVersionConfig
- NetworkConfig
- Consumidor
- Estado
- Nível
- MetadataIntegration
- DataCatalogConfig
- DataplexConfig
- Lago
- MaintenanceWindow
- MetadataManagementActivity
- MetadataExport
- Estado
- Restaurar
- Estado
- RestoreType
- ReleaseChannel
- EncryptionConfig
- DatabaseType
- TelemetryConfig
- LogFormat
- ScalingConfig
- InstanceSize
- AutoscalingConfig
- LimitConfig
- MultiRegionConfig
- RootCACertificate
- CustomRegionConfig
- ScheduledBackup
- LatestBackup
- Estado
- Métodos
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 ( |
Campos | |
---|---|
name |
Imutável. O nome do recurso relativo do serviço de metastore, no seguinte formato:
|
createTime |
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: |
updateTime |
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: |
labels |
Rótulos definidos pelo usuário para o serviço de metastore. Um objeto com uma lista de pares |
network |
Imutável. O nome do recurso relativo da rede VPC em que a instância pode ser acessada. Ele é especificado da seguinte forma:
|
endpointUri |
Apenas saída. O URI do endpoint usado para acessar o serviço do metastore. |
port |
A porta TCP em que o serviço do metastore é alcançada. Padrão: 9083 |
state |
Apenas saída. O estado atual do serviço da metastore. |
stateMessage |
Apenas saída. Outras informações sobre o estado atual do serviço de metastore, se disponíveis. |
artifactGcsUri |
Apenas saída. Um URI do Cloud Storage (começando com |
tier |
O nível do serviço. |
metadataIntegration |
Opcional. A configuração que define como os metadados do metastore precisam ser integrados a serviços e sistemas externos. |
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 |
Apenas saída. O identificador de recurso globalmente exclusivo do serviço de metastore. |
metadataManagementActivity |
Apenas saída. As atividades de gerenciamento de metadados do serviço de metastore. |
releaseChannel |
Imutável. O canal de lançamento do serviço. Se não for especificado, |
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 |
A configuração que especifica as configurações de rede para o serviço do metastore do Dataproc. |
databaseType |
Imutável. O tipo de banco de dados em que o serviço do Metastore armazena os dados. |
telemetryConfig |
A configuração que especifica as configurações de telemetria para o serviço Metastore do Dataproc. Se não for especificado, |
scalingConfig |
Configurações de escalonamento do serviço de metastore. |
multiRegionConfig |
Opcional. Especifica as informações de configuração multirregional para o serviço de metastore do Hive. |
scheduledBackup |
Opcional. A configuração do backup programado para o serviço de metastore. |
deletionProtection |
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 |
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 ( |
Campos | |
---|---|
version |
Imutável. A versão do esquema do metastore do Hive. |
configOverrides |
Um mapeamento de pares de chave-valor de configuração do metastore do Hive a serem aplicados a ele (configurado em Um objeto com uma lista de pares |
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 |
endpointProtocol |
O protocolo a ser usado para o endpoint de serviço do metastore. Se não for especificado, |
auxiliaryVersions |
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 |
KerberosConfig
Informações de configuração para um principal do Kerberos.
Representação JSON |
---|
{
"keytab": {
object ( |
Campos | |
---|---|
keytab |
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 |
Um principal do Kerberos que existe no keytab e no KDC para autenticação. Um principal típico é do formato |
krb5ConfigGcsUri |
Um URI do Cloud Storage que especifica o caminho para um arquivo krb5.conf. Ele tem o formato |
Secret
Um valor armazenado com segurança.
Representação JSON |
---|
{ // Union field |
Campos | |
---|---|
Campo de união
|
|
cloudSecret |
O nome do recurso relativo de uma versão do secret do Secret Manager, neste formato:
|
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 ( |
Campos | |
---|---|
version |
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 |
Um mapeamento de pares de chave-valor de configuração do metastore do Hive a serem aplicados ao metastore auxiliar do Hive (configurado em Um objeto com uma lista de pares |
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 ( |
Campos | |
---|---|
consumers[] |
Imutável. A configuração de rede do lado do consumidor para a instância do metastore do Dataproc. |
customRoutesEnabled |
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 |
Campos | |
---|---|
endpointUri |
Apenas saída. O URI do endpoint usado para acessar o serviço do metastore. |
endpointLocation |
Apenas saída. O local do URI do endpoint. Formato: |
Campo de união
|
|
subnetwork |
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:
|
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 ( |
Campos | |
---|---|
dataCatalogConfig |
Opcional. A configuração de integração do serviço do Data Catalog. |
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 |
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 ( |
Campos | |
---|---|
lakeResources |
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: Um objeto com uma lista de pares |
Lake
Representa um recurso Lake
Representação JSON |
---|
{ "name": string } |
Campos | |
---|---|
name |
O nome do recurso do lago. Exemplo: |
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 ( |
Campos | |
---|---|
hourOfDay |
A hora do dia (0 a 23) em que a janela começa. |
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 ( |
Campos | |
---|---|
metadataExports[] |
Apenas saída. As exportações de metadados mais recentes do serviço do metastore. |
restores[] |
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 ( |
Campos | |
---|---|
startTime |
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: |
endTime |
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: |
state |
Apenas saída. O estado atual da exportação. |
databaseDumpType |
Apenas saída. O tipo de despejo do banco de dados. |
Campo de união
|
|
destinationGcsUri |
Apenas saída. Um URI do Cloud Storage de uma pasta para onde os metadados são exportados, no formato |
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 ( |
Campos | |
---|---|
startTime |
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: |
endTime |
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: |
state |
Apenas saída. O estado atual da restauração. |
backup |
Apenas saída. O nome do recurso relativo do backup do serviço do metastore a ser restaurado, neste formato:
|
type |
Apenas saída. O tipo de restauração. |
details |
Apenas saída. Os detalhes de restauração que contêm a revisão do serviço a ser restaurado, no formato JSON. |
backupLocation |
Opcional. Um URI do Cloud Storage que especifica onde os artefatos de backup são armazenados, no formato |
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 |
O cliente forneceu o nome da chave do Cloud KMS totalmente qualificado para usar na criptografia dos dados do cliente, no seguinte formato:
|
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 ( |
Campos | |
---|---|
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 ( |
Campos | |
---|---|
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 |
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 |
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 ( |
Campos | |
---|---|
autoscalingFactor |
Apenas saída. O fator de escalonamento de um serviço com o escalonamento automático ativado. |
autoscalingEnabled |
Opcional. Indica se o escalonamento automático está ativado para este serviço. |
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 |
Opcional. O maior fator de escalonamento para o qual o serviço precisa ser escalonado automaticamente. |
minScalingFactor |
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 ( |
Campos | |
---|---|
certificates[] |
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 |
|
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 |
O certificado da CA raiz no formato PEM. O comprimento máximo é de 65.536 bytes. |
expirationTime |
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: |
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[] |
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[] |
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 ( |
Campos | |
---|---|
enabled |
Opcional. Define se o backup programado está ativado. O valor padrão é falso. |
cronSchedule |
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 |
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 |
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: |
backupLocation |
Opcional. Um URI do Cloud Storage de uma pasta, no formato |
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 ( |
Campos | |
---|---|
backupId |
Apenas saída. O ID de um backup programado em andamento. Vazia se nenhum backup estiver em andamento. |
startTime |
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: |
state |
Apenas saída. O estado atual do backup. |
duration |
Apenas saída. A duração da conclusão do backup. Duração em segundos com até nove dígitos fracionários, terminando em " |
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 |
|
---|---|
|
Alterar o local do recurso de metadados. |
|
Alterar as propriedades da tabela de metadados. |
|
Cancela o processo de migração gerenciada em andamento. |
|
Conclui o processo de migração gerenciada. |
|
Cria um serviço de metastore em um projeto e local. |
|
Exclui um único serviço. |
|
Exporta metadados de um serviço. |
|
Recebe os detalhes de um único serviço. |
|
Busca a política de controle de acesso de um recurso. |
|
Lista serviços em um projeto e local. |
|
Mover uma tabela para outro banco de dados. |
|
Atualiza os parâmetros de um único serviço. |
|
Consultar metadados do Dataproc Metastore. |
|
Remove as políticas do IAM anexadas a um recurso |
|
Restaura um serviço de um backup. |
|
Define a política de controle de acesso no recurso especificado. |
|
Inicia o processo de migração gerenciada. |
|
Retorna permissões do autor da chamada no recurso especificado. |