Condividi tramite


Database interface

Una risorsa di database.

Extends

Proprietà

autoPauseDelay

Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata

availabilityZone

Specifica la zona di disponibilità a cui viene aggiunto il database.

catalogCollation

Regole di confronto del catalogo di metadati.

collation

Regole di confronto del database.

createMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

creationDate

Data di creazione del database (formato ISO8601). NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

currentBackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

currentServiceObjectiveName

Nome dell'obiettivo del livello di servizio corrente del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

currentSku

Nome e livello dello SKU. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

databaseId

ID del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

defaultSecondaryLocation

Area secondaria predefinita per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

earliestRestoreDate

Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato). NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

elasticPoolId

Identificatore della risorsa del pool elastico contenente il database.

encryptionProtector

URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database.

failoverGroupId

Identificatore di risorsa del gruppo di failover a cui appartiene il database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

federatedClientId

ID client usato per lo scenario cmk tra tenant per database

highAvailabilityReplicaCount

Numero di repliche secondarie associate al database utilizzato per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.

identity

Identità di Azure Active Directory del database.

isInfraEncryptionEnabled

La crittografia a infrastruttura è abilitata per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

isLedgerOn

Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.

keys

ID risorsa delle identità assegnate dall'utente da usare

kind

Tipo di database. Si tratta di metadati usati per l'esperienza del portale di Azure. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

licenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

longTermRetentionBackupResourceId

Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.

maintenanceConfigurationId

ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.

managedBy

Risorsa che gestisce il database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

manualCutover

Indica se il cutover manuale controllato dal cliente deve essere eseguito durante l'operazione Aggiorna database al livello Hyperscale.

Questa proprietà è applicabile solo quando si ridimensiona il database dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale.

Quando si specifica manualCutover, l'operazione di ridimensionamento attenderà l'input dell'utente per attivare il cutover nel database Hyperscale.

Per attivare il cutover, specificare il parametro 'performCutover' quando l'operazione di ridimensionamento è in stato In attesa.

maxLogSizeBytes

Dimensioni massime del log per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

maxSizeBytes

Dimensione massima del database espressa in byte.

minCapacity

Capacità minima allocata dal database, se non sospesa

pausedDate

Data in cui il database è stato sospeso dalla configurazione utente o dall'azione (formato ISO8601). Null se il database è pronto. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

performCutover

Per attivare il cutover manuale controllato dal cliente durante lo stato di attesa mentre è in corso l'operazione di ridimensionamento.

Questo parametro di proprietà è applicabile solo per le operazioni di ridimensionamento avviate insieme al parametro 'manualCutover'.

Questa proprietà è applicabile solo quando il database viene ridimensionato dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale è già in corso.

Quando si specifica performCutover, l'operazione di ridimensionamento attiverà il cutover e eseguirà la modifica del ruolo nel database Hyperscale.

preferredEnclaveType

Tipo di enclave richiesto nel database, ad esempio enclave predefiniti o VBS.

readScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

recoverableDatabaseId

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

recoveryServicesRecoveryPointId

Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.

requestedBackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

requestedServiceObjectiveName

Nome dell'obiettivo del livello di servizio richiesto del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

restorableDroppedDatabaseId

Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.

restorePointInTime

Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

resumedDate

Data in cui il database è stato ripreso dall'azione dell'utente o dall'account di accesso al database (ISO8601 formato). Null se il database è sospeso. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

sampleName

Nome dello schema di esempio da applicare durante la creazione del database.

secondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo, Named e Standby.

sku

SKU del database.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
sourceDatabaseDeletionDate

Specifica l'ora di eliminazione del database.

sourceDatabaseId

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

sourceResourceId

Identificatore della risorsa dell'origine associata all'operazione di creazione del database.

Questa proprietà è supportata solo per l'edizione DataWarehouse e consente di eseguire il ripristino tra sottoscrizioni.

Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover.

Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime.

Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o ripristinare il pool SQL eliminato.

Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o del pool SQL ripristinabile.

Quando la sottoscrizione di origine appartiene a un tenant diverso rispetto alla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere il token di autenticazione per il tenant di origine. Per altri dettagli sull'intestazione "x-ms-authorization-auxiliary", vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

status

Stato del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

zoneRedundant

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.

Proprietà ereditate

id

ID risorsa. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

location

Percorso della risorsa.

name

Nome risorsa. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

tags

Tag di risorsa.

type

Tipo di risorsa. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

Dettagli proprietà

autoPauseDelay

Tempo in minuti dopo il quale il database viene sospeso automaticamente. Un valore di -1 indica che la sospensione automatica è disabilitata

autoPauseDelay?: number

Valore della proprietà

number

availabilityZone

Specifica la zona di disponibilità a cui viene aggiunto il database.

availabilityZone?: string

Valore della proprietà

string

catalogCollation

Regole di confronto del catalogo di metadati.

catalogCollation?: string

Valore della proprietà

string

collation

Regole di confronto del database.

collation?: string

Valore della proprietà

string

createMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione regolare del database.

Copia: crea un database come copia di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database di origine.

Secondario: crea un database come replica secondaria di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database primario esistente.

PointInTimeRestore: crea un database ripristinando un backup temporizzato di un database esistente. sourceDatabaseId deve essere specificato come ID risorsa del database esistente e deve essere specificato restorePointInTime.

Ripristino: crea un database ripristinando un backup con replica geografica. sourceDatabaseId deve essere specificato come ID risorsa di database recuperabile da ripristinare.

Ripristino: crea un database ripristinando un backup di un database eliminato. sourceDatabaseId deve essere specificato. Se sourceDatabaseId è l'ID risorsa originale del database, è necessario specificare sourceDatabaseDeletionDate. In caso contrario, sourceDatabaseId deve essere l'ID risorsa del database eliminato ripristinabile e sourceDatabaseDeletionDate viene ignorato. è anche possibile specificare restorePointInTime per eseguire il ripristino da un punto precedente nel tempo.

RestoreLongTermRetentionBackup: crea un database ripristinando da un insieme di credenziali di conservazione a lungo termine. recoveryServicesRecoveryPointResourceId deve essere specificato come ID risorsa del punto di ripristino.

Copia, Secondario e RestoreLongTermRetentionBackup non sono supportati per l'edizione DataWarehouse.

createMode?: string

Valore della proprietà

string

creationDate

Data di creazione del database (formato ISO8601). NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

creationDate?: Date

Valore della proprietà

Date

currentBackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

currentBackupStorageRedundancy?: string

Valore della proprietà

string

currentServiceObjectiveName

Nome dell'obiettivo del livello di servizio corrente del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

currentServiceObjectiveName?: string

Valore della proprietà

string

currentSku

Nome e livello dello SKU. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

currentSku?: Sku

Valore della proprietà

Sku

databaseId

ID del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

databaseId?: string

Valore della proprietà

string

defaultSecondaryLocation

Area secondaria predefinita per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

defaultSecondaryLocation?: string

Valore della proprietà

string

earliestRestoreDate

Registra la data e l'ora di inizio meno recente disponibili per il database (ISO8601 formato). NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

earliestRestoreDate?: Date

Valore della proprietà

Date

elasticPoolId

Identificatore della risorsa del pool elastico contenente il database.

elasticPoolId?: string

Valore della proprietà

string

encryptionProtector

URI dell'insieme di credenziali delle chiavi di Azure del database se è configurato con le chiavi gestite dal cliente del database.

encryptionProtector?: string

Valore della proprietà

string

failoverGroupId

Identificatore di risorsa del gruppo di failover a cui appartiene il database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

failoverGroupId?: string

Valore della proprietà

string

federatedClientId

ID client usato per lo scenario cmk tra tenant per database

federatedClientId?: string

Valore della proprietà

string

highAvailabilityReplicaCount

Numero di repliche secondarie associate al database utilizzato per garantire la disponibilità elevata. Non applicabile a un database Hyperscale all'interno di un pool elastico.

highAvailabilityReplicaCount?: number

Valore della proprietà

number

identity

Identità di Azure Active Directory del database.

identity?: DatabaseIdentity

Valore della proprietà

isInfraEncryptionEnabled

La crittografia a infrastruttura è abilitata per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

isInfraEncryptionEnabled?: boolean

Valore della proprietà

boolean

isLedgerOn

Indipendentemente dal fatto che questo database sia un database libro mastro, ovvero tutte le tabelle del database sono tabelle libro mastro. Nota: il valore di questa proprietà non può essere modificato dopo la creazione del database.

isLedgerOn?: boolean

Valore della proprietà

boolean

keys

ID risorsa delle identità assegnate dall'utente da usare

keys?: {[propertyName: string]: DatabaseKey}

Valore della proprietà

{[propertyName: string]: DatabaseKey}

kind

Tipo di database. Si tratta di metadati usati per l'esperienza del portale di Azure. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

kind?: string

Valore della proprietà

string

licenseType

Tipo di licenza da applicare per questo database. LicenseIncluded se è necessaria una licenza o BasePrice se si ha una licenza e si è idonei per il vantaggio Azure Hybrid.

licenseType?: string

Valore della proprietà

string

longTermRetentionBackupResourceId

Identificatore della risorsa del backup di conservazione a lungo termine associato all'operazione di creazione del database.

longTermRetentionBackupResourceId?: string

Valore della proprietà

string

maintenanceConfigurationId

ID di configurazione della manutenzione assegnato al database. Questa configurazione definisce il periodo in cui verranno eseguiti gli aggiornamenti della manutenzione.

maintenanceConfigurationId?: string

Valore della proprietà

string

managedBy

Risorsa che gestisce il database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

managedBy?: string

Valore della proprietà

string

manualCutover

Indica se il cutover manuale controllato dal cliente deve essere eseguito durante l'operazione Aggiorna database al livello Hyperscale.

Questa proprietà è applicabile solo quando si ridimensiona il database dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale.

Quando si specifica manualCutover, l'operazione di ridimensionamento attenderà l'input dell'utente per attivare il cutover nel database Hyperscale.

Per attivare il cutover, specificare il parametro 'performCutover' quando l'operazione di ridimensionamento è in stato In attesa.

manualCutover?: boolean

Valore della proprietà

boolean

maxLogSizeBytes

Dimensioni massime del log per questo database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

maxLogSizeBytes?: number

Valore della proprietà

number

maxSizeBytes

Dimensione massima del database espressa in byte.

maxSizeBytes?: number

Valore della proprietà

number

minCapacity

Capacità minima allocata dal database, se non sospesa

minCapacity?: number

Valore della proprietà

number

pausedDate

Data in cui il database è stato sospeso dalla configurazione utente o dall'azione (formato ISO8601). Null se il database è pronto. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

pausedDate?: Date

Valore della proprietà

Date

performCutover

Per attivare il cutover manuale controllato dal cliente durante lo stato di attesa mentre è in corso l'operazione di ridimensionamento.

Questo parametro di proprietà è applicabile solo per le operazioni di ridimensionamento avviate insieme al parametro 'manualCutover'.

Questa proprietà è applicabile solo quando il database viene ridimensionato dal livello Business Critical/Per utilizzo generico/Premium/Standard al livello Hyperscale è già in corso.

Quando si specifica performCutover, l'operazione di ridimensionamento attiverà il cutover e eseguirà la modifica del ruolo nel database Hyperscale.

performCutover?: boolean

Valore della proprietà

boolean

preferredEnclaveType

Tipo di enclave richiesto nel database, ad esempio enclave predefiniti o VBS.

preferredEnclaveType?: string

Valore della proprietà

string

readScale

Stato del routing di sola lettura. Se abilitata, le connessioni con finalità dell'applicazione impostate su readonly nella stringa di connessione potrebbero essere indirizzate a una replica secondaria di sola lettura nella stessa area. Non applicabile a un database Hyperscale all'interno di un pool elastico.

readScale?: string

Valore della proprietà

string

recoverableDatabaseId

Identificatore della risorsa del database ripristinabile associato all'operazione di creazione del database.

recoverableDatabaseId?: string

Valore della proprietà

string

recoveryServicesRecoveryPointId

Identificatore della risorsa del punto di ripristino associato all'operazione di creazione del database.

recoveryServicesRecoveryPointId?: string

Valore della proprietà

string

requestedBackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questo database.

requestedBackupStorageRedundancy?: string

Valore della proprietà

string

requestedServiceObjectiveName

Nome dell'obiettivo del livello di servizio richiesto del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

requestedServiceObjectiveName?: string

Valore della proprietà

string

restorableDroppedDatabaseId

Identificatore della risorsa del database eliminato ripristinabile associato all'operazione di creazione del database.

restorableDroppedDatabaseId?: string

Valore della proprietà

string

restorePointInTime

Specifica il punto nel tempo (formato ISO8601) del database di origine che verrà ripristinato per creare il nuovo database.

restorePointInTime?: Date

Valore della proprietà

Date

resumedDate

Data in cui il database è stato ripreso dall'azione dell'utente o dall'account di accesso al database (ISO8601 formato). Null se il database è sospeso. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

resumedDate?: Date

Valore della proprietà

Date

sampleName

Nome dello schema di esempio da applicare durante la creazione del database.

sampleName?: string

Valore della proprietà

string

secondaryType

Tipo secondario del database se è secondario. I valori validi sono Geo, Named e Standby.

secondaryType?: string

Valore della proprietà

string

sku

SKU del database.

L'elenco degli SKU può variare in base all'area geografica e all'offerta di supporto. Per determinare gli SKU (inclusi il nome dello SKU, il livello/edizione, la famiglia e la capacità) disponibili per la sottoscrizione in un'area di Azure, usare l'API REST Capabilities_ListByLocation o uno dei comandi seguenti:

az sql db list-editions -l <location> -o table
Get-AzSqlServerServiceObjective -Location <location>
sku?: Sku

Valore della proprietà

Sku

sourceDatabaseDeletionDate

Specifica l'ora di eliminazione del database.

sourceDatabaseDeletionDate?: Date

Valore della proprietà

Date

sourceDatabaseId

Identificatore della risorsa del database di origine associato all'operazione di creazione del database.

sourceDatabaseId?: string

Valore della proprietà

string

sourceResourceId

Identificatore della risorsa dell'origine associata all'operazione di creazione del database.

Questa proprietà è supportata solo per l'edizione DataWarehouse e consente di eseguire il ripristino tra sottoscrizioni.

Quando si specifica sourceResourceId, sourceDatabaseId, recoverableDatabaseId, restorableDroppedDatabaseId e sourceDatabaseDeletionDate non devono essere specificati e CreateMode deve essere PointInTimeRestore, Restore o Recover.

Quando createMode è PointInTimeRestore, sourceResourceId deve essere l'ID risorsa del database esistente o del pool SQL esistente e deve essere specificato restorePointInTime.

Quando createMode è Restore, sourceResourceId deve essere l'ID risorsa del database eliminato ripristinabile o ripristinare il pool SQL eliminato.

Quando createMode è Recover, sourceResourceId deve essere l'ID risorsa del database recuperabile o del pool SQL ripristinabile.

Quando la sottoscrizione di origine appartiene a un tenant diverso rispetto alla sottoscrizione di destinazione, l'intestazione "x-ms-authorization-auxiliary" deve contenere il token di autenticazione per il tenant di origine. Per altri dettagli sull'intestazione "x-ms-authorization-auxiliary", vedere https://docs.microsoft.com/en-us/azure/azure-resource-manager/management/authenticate-multi-tenant

sourceResourceId?: string

Valore della proprietà

string

status

Stato del database. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

status?: string

Valore della proprietà

string

zoneRedundant

Indipendentemente dal fatto che il database sia con ridondanza della zona, ovvero le repliche di questo database verranno distribuite in più zone di disponibilità.

zoneRedundant?: boolean

Valore della proprietà

boolean

Dettagli proprietà ereditate

id

ID risorsa. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

id?: string

Valore della proprietà

string

ereditato daTrackedResource.id

location

Percorso della risorsa.

location: string

Valore della proprietà

string

ereditato daTrackedResource.location

name

Nome risorsa. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

name?: string

Valore della proprietà

string

ereditato daTrackedResource.name

tags

Tag di risorsa.

tags?: {[propertyName: string]: string}

Valore della proprietà

{[propertyName: string]: string}

ereditato daTrackedResource.tags

type

Tipo di risorsa. NOTA: questa proprietà non verrà serializzata. Può essere popolato solo dal server.

type?: string

Valore della proprietà

string

ereditato daTrackedResource.type