Importe un projet de photographie oblique au format OSGB depuis Object Storage Service (OSS) vers une base de données PolarDB. Renvoie true en cas de succès.
Syntaxe
boolean ST_ImportOSGB(cstring table_name, cstring url, cstring options default '{}');
Paramètres
| Paramètre | Type | Description |
|---|---|---|
table_name |
cstring | Nom de la table OSG principale et préfixe de sa table de tuiles. |
url |
cstring | Chemin OSS vers le répertoire du projet OSGB. Le cluster et le compartiment OSS doivent se trouver dans la même région. Utilisez un endpoint interne pour l'accès. Consultez la rubrique Chemins d'accès au service de stockage d'objets. |
options |
cstring | Objet JSON contenant les options d'importation. Valeur par défaut : '{}'. Voir la section Options ci-dessous. |
Options
| Champ | Type | Valeur par défaut | Obligatoire | Description |
|---|---|---|---|---|
schema |
String | public |
Non | Schéma de la table de destination. |
parallel |
Integer | 1 |
Non | Degré de parallélisme. Définissez une valeur inférieure à 16. Les valeurs inférieures à 1 sont ignorées. Des valeurs plus élevées accélèrent l'importation mais augmentent l'utilisation de la mémoire. Si ce paramètre est défini sur une valeur autre que 1, créez les tables manuellement avant l'importation. |
batch_size |
Integer | 10000 |
Non | Nombre d'instructions SQL exécutées par lot. Valeurs valides : 1–2 147 483 647. |
project |
String | — | Non | Nom du projet. Transmis au champ project_name de chaque enregistrement. |
srid |
Integer | — | Non | Identifiant de référence spatiale (SRID) des données. Remplace le SRID lu depuis metadata.xml. |
gateway |
Boolean | false |
Non | Indique si les données doivent être importées en mode passerelle. Si la valeur est true, les enregistrements sont stockés sous forme de références et récupérés depuis OSS au moment de la requête, ce qui réduit l'utilisation du stockage de la base de données mais peut ralentir les requêtes. Si la valeur est false, les données des tuiles sont stockées directement dans la base de données. |
tileset_prefix |
String | — | Non | Préfixe des adresses 3D Tiles générées. Utilisez cette option pour configurer un proxy inverse personnalisé. |
Limitations
Seuls les fichiers OSGB sont pris en charge.
Un fichier
metadata.xmldoit exister dans le répertoire spécifié. Il peut se trouver dans le répertoire racine ou dans un sous-répertoire.Importez l'intégralité du projet OSGB. Les importations partielles entraînent une perte de données.
Pour les importations volumineuses via une connexion client, augmentez le délai d'expiration du client afin d'éviter l'échec de l'importation.
Tables de sortie
Une importation réussie crée deux tables dans la base de données.
Table principale — nommée [table_name]
Stocke les métadonnées du projet de photographie oblique.
| Champ | Type de données | Description |
|---|---|---|
project_id |
uuid | ID du projet, généré automatiquement. |
project_name |
text | Nom du projet. Défini par l'option project. Vide si non spécifié. |
srid |
integer | SRID du projet. Lu depuis ModelMetadata/SRS dans metadata.xml. L'option srid est prioritaire si elle est spécifiée. |
ref_point |
geometry | Point d'ancrage 3D du projet. Lu depuis ModelMetadata/SSRSOrigin dans metadata.xml. Type : Point3DZ. |
extent |
geometry | Étendue spatiale approximative du projet. Type : PolygonZ. |
aux |
text | Contenu intégral de metadata.xml. |
tiletable |
varchar(64) | Nom de la table de tuiles. |
Table de tuiles — nommée [table_name]_tile
Stocke toutes les données de tuiles du projet.
| Champ | Type de données | Description |
|---|---|---|
project_id |
uuid | ID du projet. Identique à celui de la table principale. |
project_name |
text | Nom du projet. Identique à celui de la table principale. |
uid |
uuid | ID de la tuile, généré automatiquement. |
lod |
integer | Niveau de détail (LOD) de la tuile. Déduit du nom du fichier (par exemple, Tile_L14_0.osgb). La valeur par défaut est 0 si le LOD ne peut pas être déterminé. |
precision |
float8 | Précision estimée de la tuile, utilisée lors de l'exportation vers 3D Tiles. |
parent |
uuid | ID de la tuile parente. Vide pour les tuiles racines. |
children |
uuid[] | IDs de toutes les tuiles enfants. Vide s'il n'y en a pas. |
aux |
jsonb | Métadonnées de la tuile. Contient le nom du fichier relatif au répertoire racine du projet, accessible depuis le nœud file_name. |
tile |
scene | Entité de la tuile. |
Notes d'utilisation
L'importation parallèle nécessite la création manuelle des tables. Lorsque parallel est défini sur une valeur autre que 1, la création automatique des tables est désactivée. Créez la table principale et la table de tuiles avant d'exécuter l'importation :
-- Create the primary table
CREATE TABLE IF NOT EXISTS test_osgb (
project_id uuid PRIMARY KEY,
project_name text,
srid integer,
ref_point geometry,
extent geometry,
aux text,
tiletable varchar(64) NOT NULL
);
-- Create the tile table
CREATE TABLE IF NOT EXISTS test_osgb_tile (
project_id uuid NOT NULL,
project_name text,
uid uuid NOT NULL,
lod integer,
precision float8,
parent uuid,
children uuid[],
aux jsonb,
tile scene NOT NULL,
PRIMARY KEY (project_id, uid)
);
Exemples
Importation standard
SELECT ST_ImportOSGB(
'test_osgb',
'OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/path_to_oblique_project/'
);
Renvoie : t
Importation parallèle
-- parallel: 4 enables concurrent processing.
-- Keep this value below 16 to avoid excessive memory usage.
-- When parallel != 1, create the tables manually before running this statement.
SELECT ST_ImportOSGB(
'test_osgb',
'OSS://<ak>:<ak_secret>@oss-cn-beijing-internal.aliyuncs.com/mybucket/path_to_oblique_project/',
'{"parallel": 4}'
);
Renvoie : t