github.com/matcornic/migrate@v3.3.2-0.20180717234201-feea45c20506+incompatible/database/spanner/spanner.go (about) 1 package spanner 2 3 import ( 4 "fmt" 5 "io" 6 "io/ioutil" 7 "log" 8 nurl "net/url" 9 "regexp" 10 "strings" 11 12 "golang.org/x/net/context" 13 14 "cloud.google.com/go/spanner" 15 sdb "cloud.google.com/go/spanner/admin/database/apiv1" 16 17 "github.com/golang-migrate/migrate" 18 "github.com/golang-migrate/migrate/database" 19 20 "google.golang.org/api/iterator" 21 adminpb "google.golang.org/genproto/googleapis/spanner/admin/database/v1" 22 ) 23 24 func init() { 25 db := Spanner{} 26 database.Register("spanner", &db) 27 } 28 29 // DefaultMigrationsTable is used if no custom table is specified 30 const DefaultMigrationsTable = "SchemaMigrations" 31 32 // Driver errors 33 var ( 34 ErrNilConfig = fmt.Errorf("no config") 35 ErrNoDatabaseName = fmt.Errorf("no database name") 36 ErrNoSchema = fmt.Errorf("no schema") 37 ErrDatabaseDirty = fmt.Errorf("database is dirty") 38 ) 39 40 // Config used for a Spanner instance 41 type Config struct { 42 MigrationsTable string 43 DatabaseName string 44 } 45 46 // Spanner implements database.Driver for Google Cloud Spanner 47 type Spanner struct { 48 db *DB 49 50 config *Config 51 } 52 53 type DB struct { 54 admin *sdb.DatabaseAdminClient 55 data *spanner.Client 56 } 57 58 // WithInstance implements database.Driver 59 func WithInstance(instance *DB, config *Config) (database.Driver, error) { 60 if config == nil { 61 return nil, ErrNilConfig 62 } 63 64 if len(config.DatabaseName) == 0 { 65 return nil, ErrNoDatabaseName 66 } 67 68 if len(config.MigrationsTable) == 0 { 69 config.MigrationsTable = DefaultMigrationsTable 70 } 71 72 sx := &Spanner{ 73 db: instance, 74 config: config, 75 } 76 77 if err := sx.ensureVersionTable(); err != nil { 78 return nil, err 79 } 80 81 return sx, nil 82 } 83 84 // Open implements database.Driver 85 func (s *Spanner) Open(url string) (database.Driver, error) { 86 purl, err := nurl.Parse(url) 87 if err != nil { 88 return nil, err 89 } 90 91 ctx := context.Background() 92 93 adminClient, err := sdb.NewDatabaseAdminClient(ctx) 94 if err != nil { 95 return nil, err 96 } 97 dbname := strings.Replace(migrate.FilterCustomQuery(purl).String(), "spanner://", "", 1) 98 dataClient, err := spanner.NewClient(ctx, dbname) 99 if err != nil { 100 log.Fatal(err) 101 } 102 103 migrationsTable := purl.Query().Get("x-migrations-table") 104 if len(migrationsTable) == 0 { 105 migrationsTable = DefaultMigrationsTable 106 } 107 108 db := &DB{admin: adminClient, data: dataClient} 109 return WithInstance(db, &Config{ 110 DatabaseName: dbname, 111 MigrationsTable: migrationsTable, 112 }) 113 } 114 115 // Close implements database.Driver 116 func (s *Spanner) Close() error { 117 s.db.data.Close() 118 return s.db.admin.Close() 119 } 120 121 // Lock implements database.Driver but doesn't do anything because Spanner only 122 // enqueues the UpdateDatabaseDdlRequest. 123 func (s *Spanner) Lock() error { 124 return nil 125 } 126 127 // Unlock implements database.Driver but no action required, see Lock. 128 func (s *Spanner) Unlock() error { 129 return nil 130 } 131 132 // Run implements database.Driver 133 func (s *Spanner) Run(migration io.Reader) error { 134 migr, err := ioutil.ReadAll(migration) 135 if err != nil { 136 return err 137 } 138 139 // run migration 140 stmts := migrationStatements(migr) 141 ctx := context.Background() 142 143 op, err := s.db.admin.UpdateDatabaseDdl(ctx, &adminpb.UpdateDatabaseDdlRequest{ 144 Database: s.config.DatabaseName, 145 Statements: stmts, 146 }) 147 148 if err != nil { 149 return &database.Error{OrigErr: err, Err: "migration failed", Query: migr} 150 } 151 152 if err := op.Wait(ctx); err != nil { 153 return &database.Error{OrigErr: err, Err: "migration failed", Query: migr} 154 } 155 156 return nil 157 } 158 159 // SetVersion implements database.Driver 160 func (s *Spanner) SetVersion(version int, dirty bool) error { 161 ctx := context.Background() 162 163 _, err := s.db.data.ReadWriteTransaction(ctx, 164 func(ctx context.Context, txn *spanner.ReadWriteTransaction) error { 165 m := []*spanner.Mutation{ 166 spanner.Delete(s.config.MigrationsTable, spanner.AllKeys()), 167 spanner.Insert(s.config.MigrationsTable, 168 []string{"Version", "Dirty"}, 169 []interface{}{version, dirty}, 170 )} 171 return txn.BufferWrite(m) 172 }) 173 if err != nil { 174 return &database.Error{OrigErr: err} 175 } 176 177 return nil 178 } 179 180 // Version implements database.Driver 181 func (s *Spanner) Version() (version int, dirty bool, err error) { 182 ctx := context.Background() 183 184 stmt := spanner.Statement{ 185 SQL: `SELECT Version, Dirty FROM ` + s.config.MigrationsTable + ` LIMIT 1`, 186 } 187 iter := s.db.data.Single().Query(ctx, stmt) 188 defer iter.Stop() 189 190 row, err := iter.Next() 191 switch err { 192 case iterator.Done: 193 return database.NilVersion, false, nil 194 case nil: 195 var v int64 196 if err = row.Columns(&v, &dirty); err != nil { 197 return 0, false, &database.Error{OrigErr: err, Query: []byte(stmt.SQL)} 198 } 199 version = int(v) 200 default: 201 return 0, false, &database.Error{OrigErr: err, Query: []byte(stmt.SQL)} 202 } 203 204 return version, dirty, nil 205 } 206 207 // Drop implements database.Driver. Retrieves the database schema first and 208 // creates statements to drop the indexes and tables accordingly. 209 // Note: The drop statements are created in reverse order to how they're 210 // provided in the schema. Assuming the schema describes how the database can 211 // be "build up", it seems logical to "unbuild" the database simply by going the 212 // opposite direction. More testing 213 func (s *Spanner) Drop() error { 214 ctx := context.Background() 215 res, err := s.db.admin.GetDatabaseDdl(ctx, &adminpb.GetDatabaseDdlRequest{ 216 Database: s.config.DatabaseName, 217 }) 218 if err != nil { 219 return &database.Error{OrigErr: err, Err: "drop failed"} 220 } 221 if len(res.Statements) == 0 { 222 return nil 223 } 224 225 r := regexp.MustCompile(`(CREATE TABLE\s(\S+)\s)|(CREATE.+INDEX\s(\S+)\s)`) 226 stmts := make([]string, 0) 227 for i := len(res.Statements) - 1; i >= 0; i-- { 228 s := res.Statements[i] 229 m := r.FindSubmatch([]byte(s)) 230 231 if len(m) == 0 { 232 continue 233 } else if tbl := m[2]; len(tbl) > 0 { 234 stmts = append(stmts, fmt.Sprintf(`DROP TABLE %s`, tbl)) 235 } else if idx := m[4]; len(idx) > 0 { 236 stmts = append(stmts, fmt.Sprintf(`DROP INDEX %s`, idx)) 237 } 238 } 239 240 op, err := s.db.admin.UpdateDatabaseDdl(ctx, &adminpb.UpdateDatabaseDdlRequest{ 241 Database: s.config.DatabaseName, 242 Statements: stmts, 243 }) 244 if err != nil { 245 return &database.Error{OrigErr: err, Query: []byte(strings.Join(stmts, "; "))} 246 } 247 if err := op.Wait(ctx); err != nil { 248 return &database.Error{OrigErr: err, Query: []byte(strings.Join(stmts, "; "))} 249 } 250 251 if err := s.ensureVersionTable(); err != nil { 252 return err 253 } 254 255 return nil 256 } 257 258 func (s *Spanner) ensureVersionTable() error { 259 ctx := context.Background() 260 tbl := s.config.MigrationsTable 261 iter := s.db.data.Single().Read(ctx, tbl, spanner.AllKeys(), []string{"Version"}) 262 if err := iter.Do(func(r *spanner.Row) error { return nil }); err == nil { 263 return nil 264 } 265 266 stmt := fmt.Sprintf(`CREATE TABLE %s ( 267 Version INT64 NOT NULL, 268 Dirty BOOL NOT NULL 269 ) PRIMARY KEY(Version)`, tbl) 270 271 op, err := s.db.admin.UpdateDatabaseDdl(ctx, &adminpb.UpdateDatabaseDdlRequest{ 272 Database: s.config.DatabaseName, 273 Statements: []string{stmt}, 274 }) 275 276 if err != nil { 277 return &database.Error{OrigErr: err, Query: []byte(stmt)} 278 } 279 if err := op.Wait(ctx); err != nil { 280 return &database.Error{OrigErr: err, Query: []byte(stmt)} 281 } 282 283 return nil 284 } 285 286 func migrationStatements(migration []byte) []string { 287 regex := regexp.MustCompile(";$") 288 migrationString := string(migration[:]) 289 migrationString = strings.TrimSpace(migrationString) 290 migrationString = regex.ReplaceAllString(migrationString, "") 291 292 statements := strings.Split(migrationString, ";") 293 return statements 294 }