CREATE STORAGE INTEGRATION (stockage interne Postgres)¶

Crée une nouvelle intégration de stockage dans le compte ou remplace une intégration de stockage existante pour le stockage interne Postgres pour accéder au stockage géré associé à une instance Snowflake Postgres.

Contrairement au type POSTGRES_EXTERNAL_STORAGE (qui vous oblige à fournir votre propre compartiment S3 et rôle IAM), une intégration POSTGRES_INTERNAL_STORAGE utilise le stockage géré qui est automatiquement alloué par l’instance Postgres.

Voir aussi :: ALTER STORAGE INTEGRATION , DROP INTEGRATION , SHOW INTEGRATIONS, DESCRIBE INTEGRATION

Syntaxe¶

CREATE [ OR REPLACE ] STORAGE INTEGRATION [ IF NOT EXISTS ] <name>
  TYPE = POSTGRES_INTERNAL_STORAGE
  POSTGRES_INSTANCE = '<instance_name>'
  [ ENABLED = { TRUE | FALSE } ]
  [ COMMENT = '<string_literal>' ]

Paramètres¶

name

Chaîne spécifiant l’identificateur (le nom) de l’intégration de stockage ; elle doit être unique sur votre compte.

De plus, l’identificateur doit commencer par un caractère alphabétique et ne peut pas contenir d’espaces ou de caractères spéciaux à moins que toute la chaîne d’identificateur soit délimitée par des guillemets doubles (par exemple, "My object"). Les identificateurs entre guillemets doubles sont également sensibles à la casse.

Pour plus d’informations, voir Exigences relatives à l’identificateur.

TYPE = POSTGRES_INTERNAL_STORAGE

Spécifie que le type d’intégration est pour le stockage géré (interne) par Postgres.

POSTGRES_INSTANCE = 'instance_name'

Spécifie le nom de l’instance Snowflake Postgres. Requis. L’instance Postgres doit afficher un état READY. Pour créer une instance Postgres, consultez CREATE POSTGRES INSTANCE.

ENABLED = { TRUE | FALSE }

Spécifie si cette intégration de stockage est disponible pour une utilisation dans des zones de préparation.

TRUE permet aux utilisateurs de créer de nouvelles zones de préparation faisant référence à cette intégration.

FALSE empêche les utilisateurs de créer de nouvelles zones de préparation faisant référence à cette intégration. Vous pouvez créer une intégration de stockage dans un état désactivé et l’activer ultérieurement à l’aide de ALTERSTORAGEINTEGRATION.

La valeur est insensible à la casse.

Par défaut : TRUE

COMMENT = 'string_literal'

Chaîne (littéral) qui spécifie un commentaire pour l’intégration.

Par défaut : aucune valeur

Exigences en matière de contrôle d’accès¶

Un rôle utilisé pour exécuter cette opération doit au minimum disposer des privilèges suivants :


Privilège	Objet	Remarques
CREATE INTEGRATION	Compte	Only the ACCOUNTADMIN role has this privilege by default. The privilege can be granted to additional roles as needed.
OWNERSHIP	Instance Postgres	Requis sur l’instance Postgres spécifiée par `POSTGRES_INSTANCE`.

Pour obtenir des instructions sur la création d’un rôle personnalisé avec un ensemble spécifique de privilèges, voir Création de rôles personnalisés.

Pour des informations générales sur les rôles et les privilèges accordés pour effectuer des actions SQL sur des objets sécurisables, voir Aperçu du contrôle d’accès.

Exemples¶

L’exemple suivant crée une intégration de stockage pour le stockage interne de Postgres. Le paramètre ENABLED par défaut est``TRUE`` et est omis :

CREATE STORAGE INTEGRATION postgres_internal
  TYPE = POSTGRES_INTERNAL_STORAGE
  POSTGRES_INSTANCE = 'my_pg_instance';