Mettre à jour les propriétés d’un jeu de données MFC (connexion d'entités multi-fichier) (Outils GeoAnalytics Desktop)

Résumé

Met à jour les propriétés d’un jeu de données MFC (connexion d'entités multi-fichier). Cet outil modifie les paramètres de champ, de géométrie, de temps et de fichier d’un jeu de données MFC spécifié.

Utilisation

Cet outil requiert une connexion MFC. Pour créer une connexion d’entités multi-fichier, utilisez la boîte de dialogue New Multifile Feature Connection (Nouvelle connexion d’entités multi-fichier) ou l’outil Create Multifile Feature Connection (Créer une connexion d’entités multi-fichier).
Utilisez cet outil pour modifier la structure, la géométrie ou les paramètres temporels du jeu de données MFC à des fins d’analyse ou de visualisation dans des scénarios tels que les suivants :
- Votre jeu de données CSV a été inscrit avec tous les champs de type chaîne et vous souhaitez définir les champs comme numériques en vue de l’analyse.
- Votre jeu de données MFC comporte des valeurs attributaires pour deux localisations distinctes (par exemple, des stations de taxi de départ et d’arrivée) et vous souhaitez modifier la géométrie utilisée pour l’analyse.
- Pour votre processus, des paramètres temporels doivent être définis sur la couche en entrée.
- Vous souhaitez partager un jeu de données MFC avec un collègue qui ne s’intéresse qu’à un sous-ensemble d’entités et ajoutez donc une expression d’ensemble de définition et masquez certains champs inutiles.
Vous pouvez modifier les propriétés suivantes :
- [Definition query](../../help/data/big-data-connections/big-data-connection-filters.mdExpression permettant de limiter les entités utilisées dans l’analyse.
- [Fields](../../help/data/big-data-connections/big-data-connection-field-properties.mdNom de champ, type de champ et visibilité.
- [Geometry](../../help/data/big-data-connections/big-data-connection-geometry-properties.mdMode de représentation de la géométrie. Ces propriétés ne sont pas modifiables pour les shapefiles.
- [Time](../../help/data/big-data-connections/big-data-connection-time-properties.mdMode de représentation du temps.
- [File](../../help/data/big-data-connections/big-data-connection-file-properties.mdPropriétés de fichier utilisées pour lire le jeu de données.
La boîte de dialogue New Multifile Feature Connection (Nouvelle connexion MFC [connexion d’entités multi-fichier]) permet de créer, mettre à jour et prévisualiser une connexion MFC (connexion d’entités multi-fichier).
Spécifiez le jeu de données MFC avec les propriétés à modifier à l’aide du paramètre Multifile Feature Connection Dataset (Jeu de données MFC [connexion d’entités multi-fichier]). Vous pouvez accéder au jeu de données ou le spécifier à l’aide d’un chemin tel que c:\<path>\MyMFC.mfc\<dataset_name> (par exemple, c:\MyMFCFolder\MyMFC.mfc\earthquakes_dataset).
Définissez une expression pour limiter les entités utilisées dans les analyses à l’aide du paramètre Expression. L’ajout d’un filtre à un jeu de données MFC est similaire à l’application d’un ensemble de définition à un jeu de données sur une carte : spécifiez une expression SQL pour filtrer les entités d’intérêt.
Vous pouvez mettre à jour le type de champ pour les fichiers délimités. Vous ne pouvez pas mettre à jour le type de champ des autres sources de données (shapefiles, ORC ou fichiers Parquet).
Vous pouvez modifier la géométrie des fichiers délimités, ORC et Parquet. Vous ne pouvez pas modifier la géométrie d’un jeu de données provenant d’un shapefile.

La table ci-après indique comment spécifier les formats temporels des paramètres Start Time (Heure de début) et End Time (Heure de fin) lorsque vous mettez à jour un jeu de données MFC. Les exemples expliquent comment représenter le 2 janvier 2016 à 21:45:02.05.

Formats temporels dans les connexions d'entités multi-fichier


Symbole	Signification	Exemple
aa	L'année, représentée par deux chiffres.	`16`
aaaa	L'année, représentée par quatre chiffres.	`2016`
MM	Le mois, représenté numériquement.	`01` ou `1`
MMM	Le mois, représenté avec trois lettres.	`Jan`
MMMM	Le mois, représenté avec l'orthographe complète.	`January`
jj	Le jour.	`02` ou `2`
HH	Heure, avec un jour de 24 heures et des valeurs comprises entre 0 et 23.	`21`
hh	Heure avec un jour de 12 heures et des valeurs comprises entre 1 et 12.	`9`
mm	Minute, avec des valeurs comprises entre 0 et 59.	`45`
ss	Seconde, avec des valeurs comprises entre 0 et 59.	`02`
SSS	Milliseconde, avec des valeurs comprises entre 0 et 999.	`50`
a	Symbole ponctuel AM/PM.	`PM`
epoch_millis	Le temps en millisecondes, d’epoch.	`1509581781000`
epoch_seconds	Le temps en secondes, d’epoch.	`1509747601`
Z	Le décalage du fuseau horaire exprimé en heures.	`-0100` ou `-01:00`
ZZZ	Le décalage du fuseau horaire exprimé à l’aide d’ID.	`America/Los_Angeles`
''	Utilisez les guillemets simples pour ajouter du texte qui ne représente pas une valeur décrite dans cette table.	`'T'`

Le tableau suivant fournit des exemples de différents formats de la même date : 2 janvier 2016 à 21:45:02.05 :

Exemples de format temporel :


Date en entrée	Format de date
01/02/2016 9:45:02PM	MM/jj/aaaa hh:mm:ssa
Jan02-16 21:45:02	MMMjj-aa HH:mm:ss
2 janvier 2016 9:45:02.050PM	MMMM jj aaaa hh:mm:ss.SSSa
01/02/2017T9:45:14:05-0000	MM/jj/aaaa'T'HH:mm:ssZ

Vous pouvez spécifier le fuseau horaire à l’aide de l’un des éléments suivants :

Le nom complet du fuseau horaire, par exemple, Heure normale du Pacifique
Le décalage du fuseau horaire exprimé en heures : -0100 ou -01:00
L’abréviation UTC ou GMT

Vous pouvez modifier les propriétés suivantes d’un fichier délimité :
- Field Delimiter—Le délimiteur de chaque champ. Les délimiteurs les plus courants sont la virgule (,) et le point-virgule (;).
- Record Terminator—La terminaison de chaque ligne de données. Les terminaisons les plus courantes sont \n et \t.
- Quote Character—Caractère utilisé pour les guillemets dans le jeu de données source.
- Has Header Row—Valeur vraie ou fausse indiquant si le jeu de données source comprend ou non des en-têtes. Si une ligne d’en-têtes est comprise dans le jeu de données, les en-têtes sont utilisés pour les noms de champs.
- Encoding—Type de codage utilisé par le jeu de données source. La valeur par défaut est UTF-8.
L’outil Update Multifile Feature Connection Dataset Properties (Mettre à jour les propriétés d’un jeu de données MFC [connexion d’entités multi-fichier]) met à jour les propriétés d’un jeu de données individuel. Utiisez les outils suivants pour modifier une MFC :
- Copy Dataset From Multifile Feature Connection (Copier un jeu de données à partir d’une connexion d’entités multi-fichier) : -copie un jeu de données d’une connexion d’entités multi-fichier dans une classe d’entités.
- Duplicate Dataset From Multifile Feature Connection (Dupliquer un jeu de données à partir d’une connexion d’entités multi-fichier) : crée une vue d’un jeu de données MFC existant.
- Refresh Multifile Feature Connection (Actualiser une connexion d’entités multi-fichier) : recherche les nouveaux jeux de données et les ajoute à la connexion d’entités multi-fichier.
- Remove Dataset From Multifile Feature Connection (Supprimer un jeu de données d’une connexion d’entités multi-fichier) : supprime un jeu de données de la connexion d’entités multi-fichier.
- Update Multifile Feature Connection Dataset Properties (Mettre à jour les propriétés d’un jeu de données de connexion d’entités multi-fichier) : modifie les propriétés d’un jeu de données MFC individuel.
- Preview Dataset From Multifile Feature Connection (Prévisualiser un jeu de données à partir d’une connexion d’entités multi-fichier) : prévisualise les dix premières entités de votre jeu de données pour vérifier qu’elles sont correctement inscrites.
- Describe Dataset (Décrire un jeu de données) : permet de vérifier que le jeu de données s’affiche comme prévu.
Vous pouvez éventuellement mettre à jour manuellement votre fichier MFC. Vous devez toujours modifier manuellement le fichier .mfc dans les cas suivants :
- Un ou plusieurs de vos champs sont utilisés pour représenter la localisation x,y ou z.
- Vous souhaitez mettre à jour le chemin d’accès source.
En savoir plus sur la mise en forme des fichiers de connexion d’entités multi-fichier.
Cet outil de géotraitement est mis en œuvre par Spark. Reportez-vous à la rubrique Connexions d’entités multi-fichier pour en savoir plus sur les connexions d’entités multi-fichier et leur utilisation.

Etiqueter	Explication	Type de données
Jeu de données MFC (connexion d'entités multi-fichier)	Jeu de données MFC à mettre à jour. Les options de mise à jour diffèrent selon les données source (shapefile, fichier délimité, ORC ou Parquet).	Table View
Expression (Facultatif)	Expression permettant de limiter les entités utilisées dans l’analyse.	SQL Expression
Propriétés du champ (Facultatif)	Indique le nom des champs et les propriétés qui vont être modifiés. Colonnes de la table de valeurs : Name—The field name. Type—Specifies the field type. Short—The field will be type short. Long—The field will be type long. Double—The field will be type double. Float—The field will be type float. String—The field will be type string. Date—The field will be type date. Blob—The field will be type BLOB. Big Integer—The field will be type big integer. Show—Specifies whether fields will be visible or hidden for use in geoprocessing tools. Fields will be visible by default.	Value Table
Type de géométrie (Facultatif)	Indique le type de géométrie utilisé pour représenter spatialement le jeu de données. La géométrie des jeux de données provenant d’un shapefile ne peut pas être modifiée. Point—La géométrie sera de type Point. Polyligne—La géométrie sera de type Polyligne. Polygone—La géométrie sera de type Polygone. Aucun—Aucun type de géométrie n’est spécifié.	String
Référence spatiale (Facultatif)	La valeur WKID ou la chaîne WKT qui est utilisée pour la référence spatiale du jeu de données. La valeur par défaut est WKID 4326 (WGS84). La référence spatiale des données provenant d’un shapefile ne peut pas être modifiée.	String
Type de format de la géométrie (Facultatif)	Indique comment la géométrie est mise en forme. La géométrie des données provenant d’un shapefile ne peut pas être modifiée. XYZ—Plusieurs champs représentent x, y et éventuellement z. WKT—La géométrie est représentée par un champ unique dans un champ de texte bien connu. WKB—La géométrie est représentée par un champ unique dans un champ binaire bien connu. GeoJSON—La géométrie est représentée par un champ unique au format GeoJSON. EsriJSON—La géométrie est représentée par un champ unique au format EsriJSON. EsriShape—La géométrie est représentée par un champ unique au format EsriShape.	String
Champ de géométrie (Facultatif)	Champ unique utilisé pour représenter la géométrie. Ce champ est utilisé lorsque le format de géométrie est WKT, WKB, GeoJSON, EsriJSON ou EsriShape.	String
Champ X (Facultatif)	Champ utilisé pour représenter la localisation x. Si plusieurs champs représentent la localisation x, modifiez le fichier `.mfc` manuellement.	String
Champ Y (Facultatif)	Champ utilisé pour représenter la localisation y. Si plusieurs champs représentent la localisation y, modifiez le fichier `.mfc` manuellement.	String
Champ Z (Facultatif)	Champ utilisé pour représenter la localisation z. Si plusieurs champs représentent la localisation z, modifiez le fichier `.mfc` manuellement.	String
Type de temps (Facultatif)	Indique le type de temps utilisé pour représenter temporellement le jeu de données. Intervalle—Le type de temps représente une durée avec une heure de début et une heure de fin. Instant—Le type de temps représente un instant donné dans le temps. Aucun—Le temps n’est pas activé.	String
Fuseau horaire (Facultatif)	Le fuseau horaire du jeu de données.	String
Heure de début (Facultatif)	Les champs utilisés pour définir l’heure de début et la mise en forme. Colonnes de la table de valeurs : Name—The field name. Short—The field type will be short. Long—The field type will be long. Big Integer—The field type will be big integer. Float—The field type will be float. Double—The field type will be double. Text—The field type will be text. Date—The field type will be date. Format—The field format.	Value Table
Heure de fin (Facultatif)	Les champs utilisés pour définir l’heure de fin et la mise en forme. Colonnes de la table de valeurs : Name—The field name. Short—The field type will be short. Long—The field type will be long. Big Integer—The field type will be big integer. Float—The field type will be float. Double—The field type will be double. Text—The field type will be text. Date—The field type will be date. Format—The field format.	Value Table
Extension de fichier (Facultatif)	L’extension de fichier du jeu de données source. La valeur de paramètre ne peut pas être modifiée.	String
Délimiteur de champ (Facultatif)	Le délimiteur de champ utilisé dans le jeu de données source.	String
Terminaison d’enregistrement (Facultatif)	La terminaison d’enregistrement utilisée dans le jeu de données source.	String
Guillemet (Facultatif)	Le guillemet utilisé dans le jeu de données source.	String
Comporte une ligne d’en-têtes (Facultatif)	Indique si le jeu de données source comprend ou non une ligne d’en-têtes. Activé—Le jeu de données source comprend une ligne d’en-têtes. Décoché—Le jeu de données source ne comprend pas de ligne d’en-têtes.	Boolean
Codage (Facultatif)	Le type de codage utilisé par le jeu de données source. UTF-8 est utilisé par défaut.	String

Sortie dérivée

Etiqueter	Explication	Type de données
Fichier MFC mis à jour	Fichier MFC actualisé avec les propriétés mises à jour appliquées au jeu de données spécifié.	File

arcpy.gapro.UpdateBDCDatasetProperties(bdc_dataset, {expression}, {field_properties}, {geometry_type}, {spatial_reference}, {geometry_format_type}, {geometry_field}, {x_field}, {y_field}, {z_field}, {time_type}, {time_zone}, {start_time_format}, {end_time_format}, {file_extension}, {field_delimiter}, {record_terminator}, {quote_character}, {has_header_row}, {encoding})

Nom	Explication	Type de données
bdc_dataset	Jeu de données MFC à mettre à jour. Les options de mise à jour diffèrent selon les données source (shapefile, fichier délimité, ORC ou Parquet).	Table View
expression (Facultatif)	Expression permettant de limiter les entités utilisées dans l’analyse.	SQL Expression
field_properties [field_properties,...] (Facultatif)	Indique le nom des champs et les propriétés qui vont être modifiés. Colonnes de la table de valeurs : `Name`—The field name. `Type`—Specifies the field type. `SHORT`—The field will be type short. `LONG`—The field will be type long. `DOUBLE`—The field will be type double. `FLOAT`—The field will be type float. `STRING`—The field will be type string. `DATE`—The field will be type date. `BLOB`—The field will be type BLOB. `BIG_INTEGER`—The field will be type big integer. `Show`—Specifies whether fields will be visible or hidden for use in geoprocessing tools. Fields will be visible by default.	Value Table
geometry_type (Facultatif)	Indique le type de géométrie utilisé pour représenter spatialement le jeu de données. La géométrie des jeux de données provenant d’un shapefile ne peut pas être modifiée. `POINT`—La géométrie sera de type Point. `LINE`—La géométrie sera de type Polyligne. `POLYGON`—La géométrie sera de type Polygone. `NONE`—Aucun type de géométrie n’est spécifié.	String
spatial_reference (Facultatif)	La valeur WKID ou la chaîne WKT qui est utilisée pour la référence spatiale du jeu de données. La valeur par défaut est WKID 4326 (WGS84). La référence spatiale des données provenant d’un shapefile ne peut pas être modifiée.	String
geometry_format_type (Facultatif)	Indique comment la géométrie est mise en forme. La géométrie des données provenant d’un shapefile ne peut pas être modifiée. `XYZ`—Plusieurs champs représentent x, y et éventuellement z. `WKT`—La géométrie est représentée par un champ unique dans un champ de texte bien connu. `WKB`—La géométrie est représentée par un champ unique dans un champ binaire bien connu. `GEOJSON`—La géométrie est représentée par un champ unique au format GeoJSON. `ESRIJSON`—La géométrie est représentée par un champ unique au format EsriJSON. `ESRISHAPE`—La géométrie est représentée par un champ unique au format EsriShape.	String
geometry_field (Facultatif)	Champ unique utilisé pour représenter la géométrie. Ce champ est utilisé lorsque le format de géométrie est WKT, WKB, GeoJSON, EsriJSON ou EsriShape.	String
x_field (Facultatif)	Champ utilisé pour représenter la localisation x. Si plusieurs champs représentent la localisation x, modifiez le fichier `.mfc` manuellement.	String
y_field (Facultatif)	Champ utilisé pour représenter la localisation y. Si plusieurs champs représentent la localisation y, modifiez le fichier `.mfc` manuellement.	String
z_field (Facultatif)	Champ utilisé pour représenter la localisation z. Si plusieurs champs représentent la localisation z, modifiez le fichier `.mfc` manuellement.	String
time_type (Facultatif)	Indique le type de temps utilisé pour représenter temporellement le jeu de données. `INTERVAL`—Le type de temps représente une durée avec une heure de début et une heure de fin. `INSTANT`—Le type de temps représente un instant donné dans le temps. `NONE`—Le temps n’est pas activé.	String
time_zone (Facultatif)	Le fuseau horaire du jeu de données.	String
start_time_format [start_time_format,...] (Facultatif)	Les champs utilisés pour définir l’heure de début et la mise en forme. Colonnes de la table de valeurs : `Name`—The field name. `Short`—The field type will be short. `Long`—The field type will be long. `BigInteger`—The field type will be big integer. `Float`—The field type will be float. `Double`—The field type will be double. `Text`—The field type will be text. `Date`—The field type will be date. `Format`—The field format.	Value Table
end_time_format [end_time_format,...] (Facultatif)	Les champs utilisés pour définir l’heure de fin et la mise en forme. Colonnes de la table de valeurs : `Name`—The field name. `Short`—The field type will be short. `Long`—The field type will be long. `BigInteger`—The field type will be big integer. `Float`—The field type will be float. `Double`—The field type will be double. `Text`—The field type will be text. `Date`—The field type will be date. `Format`—The field format.	Value Table
file_extension (Facultatif)	L’extension de fichier du jeu de données source. La valeur de paramètre ne peut pas être modifiée.	String
field_delimiter (Facultatif)	Le délimiteur de champ utilisé dans le jeu de données source.	String
record_terminator (Facultatif)	La terminaison d’enregistrement utilisée dans le jeu de données source.	String
quote_character (Facultatif)	Le guillemet utilisé dans le jeu de données source.	String
has_header_row (Facultatif)	Indique si le jeu de données source comprend ou non une ligne d’en-têtes. `HAS_HEADER`—Le jeu de données source comprend une ligne d’en-têtes. `NO_HEADER`—Le jeu de données source ne comprend pas de ligne d’en-têtes.	Boolean
encoding (Facultatif)	Le type de codage utilisé par le jeu de données source. UTF-8 est utilisé par défaut.	String

Sortie dérivée

Nom	Explication	Type de données
updated_bdc	Fichier MFC actualisé avec les propriétés mises à jour appliquées au jeu de données spécifié.	File

Exemple de code

Exemple d’utilisation de la fonction UpdateBDCDatasetProperties (script autonome)

Le script Python ci-après illustre l’utilisation de la fonction UpdateBDCDatasetProperties.

# Name: UpdateBDCDatasetProperties.py
# Description: Add a filter and modify the schema, time, and geometry for a MFC dataset
# Requirements: ArcGIS Pro Advanced License

# Import system modules
import arcpy

# Set local variables
dataset = r"c:\Projects\MyProjectFolder\my_BigDataConnection.mfc\myBigDataset"
filter = "COUNT > 500"
field_properties = "Field1 FLOAT true;Field2 STRING true;Field3 DOUBLE true"
geometry_type = "POINT"
sref = "4326"
geometry_format = "XYZ"
x_field = "Long"
y_field = "Lat"
z_field = ""
time_type = "INSTANT"
time_zone = "UTC"
time_formats = "Year yyyy"
file_extension = "csv"
file_delimiter = ","
file_terminator = r"\n"
file_quotechar = '"'
has_header_row = True
file_encoding = "UTF-8"

# Run Update MFC Dataset Properties
arcpy.gapro.UpdateBDCDatasetProperties(dataset, filter, field_properties, geometry_type, sref, geometry_format, "",
x_field, y_field, z_field, time_type, time_zone, time_formats, None, file_extension, file_delimiter, file_terminator,
file_quotechar, has_header_row, file_encoding)

Environnements

Cet outil n’utilise pas d’environnement de géotraitement.

Informations de licence

Basic: Non
Standard: Non
Advanced: Oui

Mettre à jour les propriétés d’un jeu de données MFC (connexion d'entités multi-fichier) (Outils GeoAnalytics Desktop)

Résumé

Utilisation

Paramètres

Sortie dérivée

Environnements

Informations de licence

Rubriques connexes