Créer ou modifier une exportation continue

Crée ou modifie un travail d’exportation continue.

Autorisations

Vous devez disposer d’au moins les autorisations de Administration de base de données pour exécuter cette commande.

Syntax

.create-or-altercontinuous-exportcontinuousExportName [over(T1, T2)] totableexternalTableName [with(propertyName propertyNameValue= [, ...]] <|)Requête

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	Description
continuousExportName	string	✔️	Nom de l’exportation continue. Doit être unique au sein de la base de données.
externalTableName	string	✔️	Nom de la cible d’exportation de table externe .
requête	string	✔️	Requête à exporter.
T1, T2	string		Liste séparée par des virgules de tables de faits dans la requête. Si elles ne sont pas spécifiées, toutes les tables référencées dans la requête sont supposées être des tables de faits. S’ils sont spécifiés, les tables qui ne figurent pas dans cette liste sont traitées comme des tables de dimension et ne sont pas délimitées, de sorte que tous les enregistrements participent à toutes les exportations. Pour plus d’informations, consultez Vue d’ensemble de l’exportation de données continue .
propertyName, propertyValue	string		Liste séparée par des virgules de propriétés facultatives.

Notes

Si la table externe cible utilise l’authentification par emprunt d’identité , vous devez spécifier une identité managée pour exécuter l’exportation continue. Pour plus d’informations, consultez Utiliser une identité managée pour exécuter un travail d’exportation continue.

Propriétés prises en charge

Propriété	Type	Description
intervalBetweenRuns	Timespan	Intervalle de temps entre les exécutions d’exportation continues. Doit être supérieur à 1 minute.
forcedLatency	Timespan	Période facultative permettant de limiter la requête aux enregistrements qui n’ont été ingérés qu’avant cette période (par rapport à l’heure actuelle). Cette propriété est utile si, par exemple, la requête effectue certaines agrégations/jointures et que vous souhaitez vous assurer que tous les enregistrements pertinents ont déjà été ingérés avant d’exécuter l’exportation.
sizeLimit	long	Limite de taille en octets d’un artefact de stockage unique en cours d’écriture (avant la compression). Plage valide : 100 Mo (par défaut) à 1 Go.
distributed	bool	Désactiver/activer l’exportation distribuée. La définition de la valeur false équivaut à un indicateur de single distribution. La valeur par défaut est true.
parquetRowGroupSize	int	Pertinent uniquement lorsque le format de données est Parquet. Contrôle la taille du groupe de lignes dans les fichiers exportés. La taille du groupe de lignes par défaut est de 100 000 enregistrements.
useNativeParquetWriter	bool	Utilisez la nouvelle implémentation d’exportation lors de l’exportation vers Parquet. Cette implémentation est un mécanisme d’exportation plus performant, plus léger en ressources. Notez qu’une colonne « datetime » exportée n’est actuellement pas prise en charge par Synapse SQL « COPY ». La valeur par défaut est false.
managedIdentity	string	Identité managée pour le compte de laquelle le travail d’exportation continue s’exécutera. L’identité managée peut être un ID d’objet ou le system mot réservé. Pour plus d’informations, consultez Utiliser une identité managée pour exécuter un travail d’exportation continue.
isDisabled	bool	Désactivez/activez l’exportation continue. La valeur par défaut est false.

Exemple

.create-or-alter continuous-export MyExport
over (T)
to table ExternalBlob
with
(intervalBetweenRuns=1h, 
 forcedLatency=10m, 
 sizeLimit=104857600)
<| T

Nom	ExternalTableName	Requête	La latence forcée	IntervalBetweenRuns	CursorScopedTables	ExportProperties
MyExport	ExternalBlob	S	00:10:00	01:00:00	[ « ['DB']. ['S'] » ]	{ « SizeLimit » : 104857600 }