CREATE DATABASE (Transact-SQL) - Analytics Platform System (PDW)

S’applique à : Système de plateforme Analytics (PDW)

Cette instruction est utilisée pour créer une base de données sur une appliance système de plateforme Analytics. Utilisez cette instruction pour créer tous les fichiers associés à une base de données d’appliance, et pour définir les options de croissance automatique et de taille maximale pour les tables de base de données et le journal des transactions.

Conventions de la syntaxe Transact-SQL

Syntaxe

CREATE DATABASE database_name
WITH (
    [ AUTOGROW = ON | OFF , ]
    REPLICATED_SIZE = replicated_size [ GB ] ,
    DISTRIBUTED_SIZE = distributed_size [ GB ] ,
    LOG_SIZE = log_size [ GB ] )
[ ; ]

Arguments

database_name

Nom de la nouvelle base de données. Pour plus d’informations sur les noms de base de données autorisés, consultez Noms de base de données réservés.

AUTOGROW = { ON | OFF }

Spécifie si les paramètres replicated_size, distributed_size et log_size augmentent automatiquement au-delà de leurs tailles spécifiées. La valeur par défaut est OFF.

Si AUTOGROW c’est ONle cas, replicated_size, distributed_size et log_size augmentez selon les besoins avec chaque insertion, mise à jour ou autre action nécessitant plus de stockage que celui qui a déjà été alloué.

Si AUTOGROW c’est OFFle cas, les tailles ne se développent pas automatiquement.

AUTOGROW est soit pour toutes les tailles, soit ONOFF pour toutes les tailles. Par exemple, il n’est pas possible de définir AUTOGROW ON pour log_size, mais pas de le définir pour replicated_size.

replicated_size [ Go ]

Nombre positif. Définit la taille (en gigaoctets entier ou décimal) pour l’espace total alloué aux tables répliquées et aux données correspondantes sur chaque nœud de calcul.

Si AUTOGROW c’est ONle cas, les tables répliquées peuvent dépasser cette limite.

Si AUTOGROW c’est OFFle cas, une erreur est retournée si un utilisateur tente de créer une table répliquée, d’insérer des données dans une table répliquée existante ou de mettre à jour une table répliquée existante de manière à augmenter la taille au-delà de replicated_size.

distributed_size [ Go ]

Nombre positif. Taille (en gigaoctets entier ou décimal) pour l’espace total alloué aux tables distribuées et aux données correspondantes à l’échelle de l’appliance.

Si AUTOGROW c’est ONle cas, les tables distribuées sont autorisées à augmenter au-delà de cette limite.

Si AUTOGROW c’est OFFle cas, une erreur est retournée si un utilisateur tente de créer une table distribuée, d’insérer des données dans une table distribuée existante ou de mettre à jour une table distribuée existante de manière à augmenter la taille au-delà de distributed_size.

log_size [ Go ]

Nombre positif. Taille (en gigaoctets entier ou décimal) du journal des transactions à l’échelle de l’appliance.

Si AUTOGROW c’est ONle cas, le fichier journal est autorisé à augmenter au-delà de cette limite. Utilisez l’instruction DBCC SHRINKLOG - Analytics Platform System (PDW) pour réduire la taille des fichiers journaux à leur taille d’origine.

Si AUTOGROW c’est OFFle cas, une erreur est retournée à l’utilisateur pour toute action qui augmenterait la taille du journal sur un nœud de calcul individuel au-delà de log_size.

Permissions

Nécessite l’autorisation CREATE ANY DATABASE dans la base de données master ou l’appartenance au rôle serveur fixe sysadmin.

L'exemple suivant fournit l'autorisation de créer une base de données à l'utilisateur de base de données Fay.

USE master;
GO

GRANT CREATE ANY DATABASE TO [Fay];
GO

Remarques

Les bases de données sont créées avec le niveau de compatibilité de base de données 120, qui est le niveau de compatibilité pour SQL Server 2014 (12.x). Cela garantit que la base de données peut utiliser toutes les fonctionnalités SQL Server 2014 (12.x) utilisées par PDW.

Limitations

L’instruction CREATE DATABASE n’est pas autorisée dans une transaction explicite. Pour plus d’informations, consultez Transact-SQL instructions.

Lors de la création d’une base de données, il doit y avoir suffisamment d’espace libre disponible sur chaque nœud de calcul pour allouer le total combiné des tailles suivantes :

Base de données SQL Server avec des tables de la taille de replicated_table_size.
Base de données SQL Server avec des tables de la taille de (distributed_table_size / nombre de nœuds de calcul).
Journaux SQL Server de la taille de (log_size / nombre de nœuds de calcul).

Verrouillage

Prend un verrou partagé sur l’objet DATABASE.

Metadata

Une fois cette opération réussie, une entrée pour cette base de données apparaît dans les vues de métadonnées sys.databases et sys.objects .

Exemples : Analytics Platform System (PDW)

A. Exemples simples de création de base de données

L’exemple suivant crée la base de données mytest avec une allocation de stockage de 100 Go par nœud de calcul pour les tables répliquées, 500 Go par appliance pour les tables distribuées et 100 Go par appliance pour le journal des transactions. Dans cet exemple, AUTOGROW est désactivé par défaut.

CREATE DATABASE mytest
  WITH
    (REPLICATED_SIZE = 100 GB,
    DISTRIBUTED_SIZE = 500 GB,
    LOG_SIZE = 100 GB );

L’exemple suivant crée la base de données mytest avec les mêmes paramètres, sauf que est AUTOGROW activé. Cela permet à la base de données de croître au-delà des paramètres de taille spécifiés.

CREATE DATABASE mytest
  WITH
    (AUTOGROW = ON,
    REPLICATED_SIZE = 100 GB,
    DISTRIBUTED_SIZE = 500 GB,
    LOG_SIZE = 100 GB);

B. Créer une base de données avec des valeurs de taille en gigaoctets partielles

L’exemple suivant crée la base de données mytest, avec AUTOGROW désactivé, une allocation de stockage de 1,5 Go par nœud de calcul pour les tables répliquées, 5,25 Go par appliance pour les tables distribuées et 10 Go par appliance pour le journal des transactions.

CREATE DATABASE mytest
  WITH
    (REPLICATED_SIZE = 1.5 GB,
    DISTRIBUTED_SIZE = 5.25 GB,
    LOG_SIZE = 10 GB);

Last updated on 2026-02-06