Tous les produits
Search
Centre de documentation

PolarDB:ST_ImportOSGB

Dernière mise à jour :Aug 24, 2026

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.xml doit 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