ST_GEOGFROMWKB |
Géographique de WKB |
| BigQuery |
Syntaxe
|
ST_GEOGFROMWKB(wkb_bytes)
|
Paramètres
| Nom |
Description |
| wkb_bytes |
Ce paramètre permet de spécifier la séquence d'octets (BYTES) au format Well-Known Binary (WKB) que vous souhaitez convertir en un objet géographique (GEOGRAPHY). Cette fonction interprète les octets WKB et crée l'objet GEOGRAPHY correspondant. Si la séquence WKB est invalide ou représente une géométrie qui ne peut pas être représentée comme un type GEOGRAPHY valide, la fonction retournera une erreur. |
Description
Cette fonction permet de créer une valeur GEOGRAPHY en utilisant une chaîne de caractères d'objet d'octets de WKB.
Remarques
- Convertit une séquence binaire en objet GEOGRAPHY : La fonction ST_GEOGFROMWKB transforme une séquence d'octets codée en Well-Known Binary (WKB) en un
objet géographique GEOGRAPHY. Ce format binaire est souvent utilisé dans les bases de données spatiales pour un stockage plus compact et une lecture plus rapide que
le texte.
- Permet de traiter des données géographiques encodées efficacement : Le WKB est souvent utilisé lorsque les géométries doivent être transmises ou
entreposées sous forme binaire, par exemple dans des échanges d'API ou des bases comme PostGIS. Cette fonction est donc essentielle pour interpréter et exploiter
ces données dans BigQuery.
- Prend en charge les principaux types de géométries : Elle accepte tous les types définis par le standard WKB : POINT, LINESTRING, POLYGON, MULTIPOINT,
MULTILINESTRING, MULTIPOLYGON, et GEOMETRYCOLLECTION. Cela assure une grande compatibilité avec les outils SIG et bases de données spatiales conformes à l'OGC.
- Génère une erreur en cas de séquence invalide : Si la chaîne d'octets WKB fournie est malformée ou invalide, ou représente une géométrie non supportée,
la fonction retournera une erreur explicite. Il est donc essentiel de s'assurer que la source binaire est bien conforme au standard WKB.
- Utile dans des contextes d'intégration système ou d'ETL : Cette fonction est particulièrement pertinente lorsque des données spatiales sont échangées
entre systèmes sous forme binaire (par exemple, entre BigQuery et un entrepôt PostGIS), notamment dans des pipelines automatisés.
- Plus performante que les formats textuels dans certains cas : Le WKB, étant plus compact que le format WKT (texte), permet des lectures plus rapides et
un entreposage optimisé. Cela peut faire une réelle différence lors du traitement de grands volumes de données géographiques dans BigQuery.
- Intégration facile avec les fonctions spatiales de BigQuery : Une fois la conversion en GEOGRAPHY effectuée, l'objet peut être manipulé avec toutes
les fonctions spatiales standard (ST_AREA, ST_DISTANCE, ST_INTERSECTS,...). Cela en fait un point d'entrée pratique pour transformer du binaire spatial en données
analytiques.
- Complète les fonctions ST_GEOGFROMTEXT et ST_GEOGFROMGEOJSON : Avec ST_GEOGFROMWKB, BigQuery couvre les trois principaux formats d'encodage des
géométries : texte (WKT), JSON (GeoJSON), et binaire (WKB). Cela permet de s'adapter à presque toutes les sources
et standards d'échange de données géographiques.
Dernière mise à jour : Jeudi, le 18 Juin 2020